C
Text QML Type
シーンにテキストを追加する方法を指定します。詳細...
| Import Statement: | import QtQuick |
| Since: | Qt Quick Ultralite 1.0 |
| Inherits: |
列挙
プロパティ
- 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オプションの一覧を提供します。
| 定数 | 説明 |
|---|---|
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 を変更す る か、 そのhorizontalAlignment をText.AlignHCenter に設定 し 、 そのwidth を親のそれにバ イ ン ド し ます。
これらのプロパティは、テキストの周りのパディングを保持します。
これらのプロパティはQt Quick Ultralite 1.1 で導入されました。
baselineOffset : int |
アイテムのベースラインの位置をローカル座標で指定します。
ベースラインは、テキストが置かれる仮想線です。
color : color |
elide : Elide |
このプロパティを設定すると、テキストの一部がテキストアイテムのサイズに合うように消去されます。
テキストアイテムはテキストをエライディングするためにその幅を明示的に定義しなければならない。
テキストアイテムが複数行のテキストを含む場合、幅と高さの両方を明示的に定義する必要があります。
を明示的に定義する必要があります。複数行テ キ ス ト は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 |
複数行テキストの行の高さを設定します。値はピクセルか、lineHeightMode に応じて乗数を指定します。
デ フ ォ ル ト 値は 1.0 です。行の高 さ は正の値でなければな り ません。
詳細についてはlineHeightMode
こ のプ ロパテ ィ はQt Quick Ultralite 2.10 で導入 さ れま し た。
lineHeightMode : LineHeightMode |
このプロパティはlineHeight の適用方法を制御します。
このプロパティはQt Quick Ultralite 2.10 で導入されました。
maximumLineCount : int |
表示される行数を制限する。elide をText.ElideRight に設定すると、テキストは適切に消去されます。
デフォルト値は可能な限り大きな整数です。
参照elide
このプロパティはQt Quick Ultralite 2.12 で導入されました。
rotation : real |
このプロパティは、アイテムの回転を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で導入されました。
scale : real |
このプロパティは、このアイテムのスケールファクターを保持する。
縮尺が 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 で導入されました。
text : string |
表示するテキスト。テキス ト は、 プ レーン テキス ト 文字列 と リ ッ チ テキス ト 文字列の両方に対応 し てい ます。
textFormatも参照 。
textFormat : TextFormat |
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\">" }
| 定数 | 説明 |
|---|---|
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で導入されました。
transformOrigin : Item::TransformOrigin |
このプロパティは、scale とrotation がトランスフォームする際の原点を保持します。
下図に示すように、9つの変換原点が利用可能です。デフ ォル ト の変形原点はItem.Center です。

こ の例はテ キ ス ト をその右下隅を中心 と し て回転 さ せます。
Text { text: "Hello" transformOrigin: Item.BottomRight rotation: 45 }
任意の変換原点を設定す る には、Scale ま たはRotation の変換 タ イ プ をtransform と と も に使います。
こ のプ ロ パテ ィ はQt Quick Ultralite 1.3 で導入 さ れま し た。
truncated : bool |
wrapMode : WrapMode |
このプロパティを設定すると、テキストはテキストアイテムの幅に折り返されます。テキストは、明示的な幅が設定されている場合にのみ折り返されます。テキストを折り返すには、以下のいずれかのモードを使用します:
注意: このプロパティは現在、StaticText アイテムではサポートされていません。
このプロパティはQt Quick Ultralite 2.2 で導入されました。
特定の Qt ライセンスの下で利用可能です。
詳細を確認してください。