Text QML Type

シーンにテキストを追加する方法を指定します。詳細...

• 継承されたメンバーを含む全メンバーのリスト

列挙

• Elide
• HorizontalAlignment
• LineHeightMode
• TextFormat
• VerticalAlignment
• WrapMode

プロパティ

• baselineOffset : int
• bottomPadding : real (since Qt Quick Ultralite 1.1)
• color : color
• elide : Elide (since Qt Quick Ultralite 2.1)
• font : font
• horizontalAlignment : HorizontalAlignment
• leftPadding : real (since Qt Quick Ultralite 1.1)
• lineHeight : real (since Qt Quick Ultralite 2.10)
• lineHeightMode : LineHeightMode (since Qt Quick Ultralite 2.10)
• maximumLineCount : int (since Qt Quick Ultralite 2.12)
• padding : real (since Qt Quick Ultralite 1.1)
• rightPadding : real (since Qt Quick Ultralite 1.1)
• rotation : real (since Qt Quick Ultralite 1.3)
• scale : real (since Qt Quick Ultralite 1.3)
• text : string
• textFormat : TextFormat (since Qt Quick Ultralite 2.6)
• topPadding : real (since Qt Quick Ultralite 1.1)
• transform : list<Transform>
• transformOrigin : Item::TransformOrigin (since Qt Quick Ultralite 1.3)
• truncated : bool
• verticalAlignment : VerticalAlignment
• wrapMode : WrapMode (since Qt Quick Ultralite 2.2)

詳細説明

テキストアイテムはプレーンテキストを表示できます。例えば、特定のfont 設定を持つ赤いテキストはこのように定義できます：

Text {
    text: "Hello World!"
    font.family: "Helvetica"
    font.pointSize: 24
    color: "red"
}

height と width が明示的に設定されていない場合、Text はどれだけのスペースが必要かを判断し、それに応じて設定しようとします。wrapMode が設定されない限り、常に height より width を優先します（すべてのテキストは1行に配置されます）。

elide プロパティを使うと、テキストを設定された幅と高さに合わせることができます。

複数行のテ キ ス ト 項目内の行間を制御す る には、lineHeight とlineHeightMode プ ロ パテ ィ の組み合わせを用います。

textFormat プロパティを使うと、text でサポートされている HTML タグの出現をどのように解釈するかを設定できます。

Text 要素はtext プロパティを動的に変更できます。表示テ キ ス ト が固定であ り 、 コ ンパ イ ル時に知 ら れてい る 場合にはStaticText を優先 し て く だ さ い。

関連項目： Text Rendering and Fonts,Text QML Type,StaticText,Managing Resources, andInternationalization and Localization withQt Quick Ultralite。

列挙ドキュメント

Elide

elide オプションのリストを提供します。

HorizontalAlignment

画像を水平に配置する選択肢のリストを提供します。

LineHeightMode

行の高さモードのリストを提供する。

TextFormat

代替テキスト書式の一覧を提供します。

VerticalAlignment

画像を垂直に整列させる選択肢のリストを提供します。

WrapMode

テキストを折り返すさまざまなオプションを提供します。

プロパティの説明

baselineOffset : int

アイテムのベースラインの位置をローカル座標で指定します。

ベースラインとは、テキストが置かれている仮想線のことです。

これらのプロパティは、テキストの周りのパディングを保持します。

これらのプロパティはQt Quick Ultralite 1.1で導入されました。

color : color

テキストの色。

16進数表記で定義された緑色のテキストの例：

Text {
    color: "#00FF00"
    text: "green text"
}

SVG色名で定義されたスチールブルーテキストの例：

Text {
    color: "steelblue"
    text: "blue text"
}

elide : Elide [default, since Qt Quick Ultralite 2.1]

このプロパティを設定すると、テキストの一部がテキストアイテムのサイズに合わせてエライドされる。

テキストアイテムの幅は、テキストを消去するために明示的に定義する必要があります。

テキストアイテムに複数行のテキストが含まれる場合は、幅と高さの両方を明示的に定義する必要があります。

を明示的に定義する必要があります。複数行テ キ ス ト はText.ElideRight （行末のエ リ ーデ ィ ン グ） にのみ対応 し てお り 、 テ キ ス ト は高 さ を超え る かmaximumLineCount に達す る と エ リ ーデ ィ ン グ を開始 し ます。

Qt Quick Ultraliteは複数行エライドモードをサポートしており、MCU.Config.Experimental.multiLineElideを使用して有効にすることができます。このモードでは、利用可能な幅を超える行はすべてエライドされます。このモードでは、明示的に高さを設定する必要はありません。

Qt Quick は複数行のエライディングをサポートしていないことに注意してください。その結果、Qt Quick Ultraliteでこのモードを有効にすると、Qt Quick とは異なる、互換性のないレイアウト動作になります。

エライドマークはテキストの方向に従います。た と えば

• - テ キ ス ト の方向は左書 き （LTR）。
• - ア ラ ビ ア文字の同 じ テ キ ス ト は右書 き （RTL） テ キ ス ト 向 き にな り ます。

エ リ ド モー ド がText.ElideRight の場合、 LTR テ キ ス ト の場合は右側に、 RTL テ キ ス ト の場合は左側にエ リ プ シ ス グ リ フ が表示 さ れます。

このプロパティはQt Quick Ultralite 2.1 で導入されました。

MCU.Config.Experimental.multiLineElideも参照してください 。

font : font

テキスト表示に使用するフォント。

テキストアイテムの幅と高さ内でのテキストの水平方向と垂直方向の配置を設定します。デフォルトでは、テキストは垂直方向に上揃え、水平方向に左揃えになります。

lineHeight : real [since Qt Quick Ultralite 2.10]

複数行テキス ト の行の高 さ を設定 し ます。値はピクセル単位か、lineHeightMode に応じた乗数です。

デフ ォル ト 値は 1.0 です。行の高 さ は正の値でなければな り ません。

詳細についてはlineHeightMode

このプロパティはQt Quick Ultralite 2.10 で導入されました。

lineHeightMode : LineHeightMode [since Qt Quick Ultralite 2.10]

このプロパティは、lineHeight の適用方法を制御します。

このプロパティはQt Quick Ultralite 2.10 で導入されました。

maximumLineCount : int [since Qt Quick Ultralite 2.12]

表示する行数を制限する。elide をText.ElideRight に設定すると、テキストは適切に消去される。

デフォルト値は可能な限り大きな整数です。

参照elide

このプロパティはQt Quick Ultralite 2.12で導入されました。

rotation : real [since Qt Quick Ultralite 1.3]

このプロパティは、アイテムの回転をtransformOrigin を中心に時計回りの度数で保持する。

デフォルト値は0度（つまり回転なし）である。

Rectangle {
    color: "blue"
    width: 100; height: 100
    Text {
        text: "Rotated Text"
        color: "red"
        x: 25; y: 25
        rotation: 30
    }
}

このプロパティはQt Quick Ultralite 1.3で導入されました。

Transform およびRotationも参照してください 。

scale : real [since Qt Quick Ultralite 1.3]

このプロパティは、このアイテムのスケールファクターを保持する。

スケールが 1.0 より小さいとアイテムは小さく表示され、1.0 より大きいと大きく表示されます。負のスケールを指定すると、アイテムはレンダリング時にミラーリングされます。

デフォルト値は 1.0 です。

スケーリングはtransformOrigin から適用されます。

import QtQuick 2.15

Rectangle {
    color: "blue"
    width: 100; height: 100

    Rectangle {
        color: "green"
        width: 25; height: 25
    }

    Text {
        text: "Scaled Text"
        color: "red"
        x: 25; y: 25
        scale: 1.4
        transformOrigin: Item.TopLeft
    }
}

このプロパティはQt Quick Ultralite 1.3 で導入されました。

Transform およびScaleも参照してください 。

text : string

表示するテキスト。Text はプレーンテキスト文字列とリッチテキスト文字列の両方をサポートしています。

textFormatも参照してください 。

textFormat : TextFormat [since Qt Quick Ultralite 2.6]

text プロパティの表示方法。

Qt Quick Ultraliteでは、StyledText とRichText の両方が同じバックエンドにマップされます。

サポートされるHTMLタグ

<img src="" align="bottom,middle,top"> - inline images in Text item
<img src="" align="bottom,middle,top" width="50" height="40"> - inline images in StaticText item

imgタグ

使用例

Text {
    textFormat: Text.StyledText
    text: "Qt <img src=\"qt-logo.png\" align=\"middle\">"
}

HTML 4の仕様による

ベースラインは、文字がその上に置かれる想像上の線です。bottomと middlealignオプションはベースラインに対する相対的なもので、topは実際の行の高さに対する相対的なものであることに注意してください。

StaticText の項目は現在、開発者が画像サイズを指定する必要があります。このサイズは、使用画像の実際のサイズでなければなりません。不一致が検出されると実行時にエラーが出力され、レンダリングされたテキストが意図したとおりに表示されない可能性があります。

StaticText {
    text: "flag <img src=\"latvia-flag-small-icon.png\" width=\"38\" height=\"20\">"
    textFormat:  Text.RichText
}

リソースの管理も参照してください。

textFormat デフォルト値Qt Quick 互換性

Qt Quick Text項目のtextFormatプロパティは、デフォルトでText.AutoTextを使用します。このフォーマット値は、実行時のオーバーヘッドを避けるためにQt Quick Ultralite では実装されていません。Qt Quick でテ キ ス ト が異な っ て表示 さ れ る よ う な稀な例が 1 つだけあ り ますが、 こ れは単純にアプ リ ケーシ ョ ン レベルで解決で き ます。次の例を考えてみましょう。

スタイル付きテキストをレンダリングするには、StyledText/RichText を明示的に設定する必要があります。以下のコードは、Qt Quick Ultralite とQt Quick で同じように動作することが期待されます。

Text {
    textFormat: Text.StyledText
    text: "Qt <img src=\"qt-logo.png\">"
}

Qt Quick UltraliteでHTMLタグを含むテキストをプレーンテキストとしてレンダリングするには、デフォルト値PlainText に頼ることになります。通常、デフォルトの動作が望ましい場合は、qmlプロパティを明示的に設定することは避けるべきです。そうすることで、よりメモリに最適化されたコードを生成することができます。

Text {
    text: "Qt <img src=\"qt-logo.png\">"
}

上の例では textFormat プロパティが明示的に設定されていないため、Qt Quick Text.AutoText の振る舞いに依存していることに注意してください。このまれなケースでは、両方の実装で望ましい動作をさせるには、textFormatプロパティを明示的に設定する必要があります。

Text {
    textFormat: Text.PlainText
    text: "Qt <img src=\"qt-logo.png\">"
}

このプロパティは、Qt Quick Ultralite 2.6で導入されました。

transform : list<Transform>

このプロパティは、適用するトランスフォームのリストを保持する。

詳細はTransform を参照。

transformOrigin : Item::TransformOrigin [since Qt Quick Ultralite 1.3]

このプロパティは、scale とrotation が変換する原点を保持します。

以下の画像に示すように、9つの変換原点が利用可能です。デフ ォル ト の変形原点はItem.Center です。

こ の例はテ キ ス ト をその右下隅を中心 と し て回転 さ せます。

Text {
    text: "Hello"
    transformOrigin: Item.BottomRight
    rotation: 45
}

任意の変換原点を設定す る には、Scale ま たはRotation の変換 タ イ プ をtransform と と も に使います。

こ のプ ロ パテ ィ はQt Quick Ultralite 1.3 で導入 さ れま し た。

truncated : bool [read-only]

テ キ ス ト がelide に よ っ て切 り 落 と さ れてい る と き は true を返 し ます。

elideも参照してください 。

wrapMode : WrapMode [since Qt Quick Ultralite 2.2]

テキストアイテムの幅に合わせてテキストを折り返すには、このプロパティを設定します。テキストは、明示的な幅が設定されている場合にのみ折り返される。テキストを折り返すには、以下のいずれかのモードを使用する：

このプロパティはQt Quick Ultralite 2.2 で導入されました。

特定の Qt ライセンスの下で利用可能です。
詳細を確認してください。