このページでは

C

Text QML Type

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

Import Statement: import QtQuick
Since: Qt Quick Ultralite 1.0
Inherits:

Item

列挙

プロパティ

詳細説明

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

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

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

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

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

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

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

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

列挙ドキュメント

Elide

elideオプションの一覧を提供します。

定数説明
Text.ElideNoneエライドしない。
Text.ElideLeft行頭のテキストを消去する
Text.ElideMiddleテキストを行の中央に寄せる
Text.ElideRightテキストを行末に寄せる

HorizontalAlignment

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

定数説明
Text.AlignLeftテキストを左に揃えます。
Text.AlignRightテキストを右に揃えます。
Text.AlignHCenterテキストを中央に揃えます。

LineHeightMode

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

定数説明
Text.ProportionalHeight各行の行間を倍増する。例えば、2 倍の行間には 2 を設定します。
Text.FixedHeight行間を固定値(ピクセル単位)に設定します。

TextFormat

テキスト書式の選択肢のリストを提供します。

定数説明
Text.PlainTextすべてのスタイルタグはプレーンテキストとして扱われます。の節も参照してください。 Qt Quick compatibility.
Text.StyledText選択された HTML タグをサポート
Text.RichTextに似ています。Text.StyledText

VerticalAlignment

画像を縦に揃えるための選択肢のリストを提供します。

定数説明
Text.AlignTopテキストを上に揃えます。
Text.AlignBottomテキストを下に揃えます。
Text.AlignVCenterテキストを中央に揃えます。

WrapMode

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

定数説明
Text.NoWrapデフォルト。折り返しは行われない。テキストが改行を含まない場合、設定された幅をオーバーします。
Text.WordWrap折り返しは単語の境界でのみ行われます。単語が Text item の幅より長い場合、テキストは設定された幅からはみ出します。
Text.WrapAnywhere折り返しは行のどの位置でも行われ、それが単語の途中であっても行われます。
Text.Wrapテ キ ス ト は、 可能な限 り 単語の境界で折 り 返 さ れますが、 そ う でない と きは行の適切な位置で折 り 返 さ れます (単語の途中であっても)。WordWrapモードとは異なり、このモードではテキストはオーバーフローしない。

プロパティの説明

horizontalAlignment : HorizontalAlignment

verticalAlignment : VerticalAlignment

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

注意: テキスト1行のサイズはテキストの面積です。この一般的なケースでは、すべての配置は等価です。テ キ ス ト をその親の中央に配置 し たい と き は、anchors を変更す る か、 そのhorizontalAlignmentText.AlignHCenter に設定 し 、 そのwidth を親のそれにバ イ ン ド し ます。


bottomPadding : real [since Qt Quick Ultralite 1.1]

leftPadding : real [since Qt Quick Ultralite 1.1]

padding : real [since Qt Quick Ultralite 1.1]

rightPadding : real [since Qt Quick Ultralite 1.1]

topPadding : real [since Qt Quick Ultralite 1.1]

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

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


baselineOffset : int

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

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


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 テ キ ス ト の場合は左側にエ リ プ シ ス グ リ フ が表示 さ れます。

注 : こ のプ ロ パテ ィ は現在StaticText 項目ではサポー ト さ れていません。

このプロパティは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]

表示される行数を制限する。elideText.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

表示するテキスト。テキス ト は、 プ レーン テキス ト 文字列 と リ ッ チ テキス ト 文字列の両方に対応 し てい ます。

textFormatも参照


textFormat : TextFormat [since Qt Quick Ultralite 2.6]

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

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

サポートされる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は、オブジェクトの底が現在のベースラインと垂直に整列されるべきであることを意味します。これはデフォルト値です。
middleは、オブジェクトの中央が現在のベースラインに垂直に整列することを意味します。
topオブジェクトの上端を現在のテキスト行の上端に垂直に揃えることを意味します。

ベースラインは、文字がその上に置かれる想像上の線です。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]

このプロパティは、scalerotation がトランスフォームする際の原点を保持します。

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

長方形で描かれた9つの変換原点。

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

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]

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

注意: このプロパティは現在、StaticText アイテムではサポートされていません。

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


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