C
SafeText QML Type
Qt Safe Renderer の出力検証を使って検証できるセーフティクリティカルな QML テキスト型を提供します。詳細...
| Import Statement: | import QtQuickUltralite.SafeRenderer |
| Since: | Qt Quick Ultralite 2.9 |
列挙
プロパティ
- color : color
- fillColor : color
- font.bold : bool
- font.family : string
- font.italic : bool
- font.pixelSize : int
- height : real
- horizontalAlignment : HAlignment
- objectName : string
- opacity : real
- runtimeEditable : bool
- text : string
- verticalAlignment : VAlignment
- width : real
- wrapMode : WrapMode
- x : real
- y : real
詳細説明
Qt Safe Rendererは、セーフテキストアイテムのフォントデータを生成するQt セーフレイアウトツールを提供します。Qt Safe Renderer出力検証により、表示内容からセーフアイテムの整合性を確保することができます。
重要な考慮事項
- Qt Quick Ultralite Safe Renderer モジュールは、Static や Spark フォントエンジンに依存しないカスタムテキストレイアウトパイプラインを使用します。
- そのため Qt Safe Rendererフォント ファイル ディレクトリは、FontFiles の代わりにMCU.Config.safeTextFontDirectoryで提供されます。
MCU.Configの下にある他のフォント・プロパティは、Qt Quick Ultralite Safe Renderer モジュールでは使用されません。- 動的 SafeText では、ISO/IEC 8859-1:1998 (Latin-1) 文字のみがサポートされます。
runtimeEditable をtrue に設定すると、テキストを実行時に変更できます。
次のコードは、SafeText タイプの例です:
SafeText { id: safeText objectName: "safeText" x: 256 y: 8 text: "Safe text.." color: "black" fillColor: "white" // optional, but recommended to use fillColor for controlled background color font.pixelSize: 12 }
objectName は必須で、項目id に一致する文字列でなければなりません。
注 : フォントサイズが 175 より大きい場合、SafeText は正しく表示されません。
注 : 静的な SafeText は常に RAM にキャッシュされ、このキャッシュ ポリシーは変更できません。
注: MCU.Config.safeTextCachePolicy を使用して、動的 SafeText リソースのキャッシュ ポリシーを設定します。
セーフティ・クリティカルな項目を持つQt Quick Ultralite アプリケーションも参照してください 。
列挙ドキュメント
HAlignment |
整列オプションのリストを提供します。
| 定数 | 説明 |
|---|---|
SafeText.AlignLeft | テキストを左に揃える。 |
SafeText.AlignHCenter | テキストを中央に揃える。 |
SafeText.AlignRight | テキストを右揃えにします。 |
SafeText.AlignJustify | テキストを利用可能なスペースで整列します。 |
VAlignment |
テキストを垂直に揃えるためのオプションのリストを提供します。
| 定数 | 説明 |
|---|---|
SafeText.AlignTop | テキストを上揃えにします。 |
SafeText.AlignVCenter | テキストを中央に揃えます。 |
SafeText.AlignBottom | テキストを下に揃える。 |
WrapMode |
テキストを折り返すオプションのリストを提供します。
| 定数 | 説明 |
|---|---|
SafeText.NoWrap | 折り返しなし。 |
SafeText.WordWrap | 単語境界でテキストを折り返す。 |
注意: runtimeEditable がtrue に設定されている場合、SafeText ではSafeText.WordWrap はサポートされません。
| 定数 | 説明 |
|---|---|
SafeText.WrapAnywhere | 行の任意の位置でテキストを折り返します。 |
SafeText.Wrap | 可能であれば、単語境界でテキストを折り返します。そうでない場合は、単語の途中であっても、行の適切な位置でテキストを折り返します。 |
プロパティの説明
color : color |
fillColor : color |
こ のプ ロ パテ ィ はテ キ ス ト の背景塗 り 色を保持 し ます。こ れは、runtimeEditable をtrue に設定す る と 、 実行時に変更で き ます。
font.bold : bool |
このプロパティはフォントスタイルが太字かどうかを保持する。
注: このプロパティは実行時には変更できない。
font.family : string |
フォントのファミリー名を設定します。
注意: デフォルトのフォントファミリーはLatoです。
注意: このプロパティは実行時に変更することはできません。
font.italic : bool |
このプロパティは、フォントスタイルがイタリック体であるかどうかを保持します。
注意: このプロパティは実行時に変更することはできません。
font.pixelSize : int |
このプロパティは、フォントサイズをピクセル単位で保持します。
注意: このプロパティを使用すると、フォントはデバイス依存になります。
注意: このプロパティは実行時に変更することはできません。
height : real |
このプロパティは、テキスト項目の高さを保持します。デフォルト値は64 です。
注意 :項目領域が小さすぎる場合、テキストは切り取られます。
注 :項目の高さの最大値は元の高さです。
注 :項目が Qt Safe Renderer.
horizontalAlignment : HAlignment |
このプロパティは、SafeText::width の範囲内でテキストの水平アライメントを保持する。 水平アライメントは、テキストの自然なアライメントに従う。例えば、左から右に読まれるテキストは左に揃えられる。
注: このプロパティは実行時に変更することはできません。
objectName : string |
このプロパティは、テキスト項目のオブジェクト名を保持する。objectName は必須で、項目id と一致する文字列でなければならない。
SafeText { id: foo objectName: "foo" // ... }
注意: このプロパティは実行時に変更することはできない。
opacity : real |
このプロパティは、項目の不透明度を保持する。不透明度は0.0(完全に透明)から1.0(完全に不透明)の間の数値で指定する。デフォルト値は1.0 である。
runtimeEditable : bool |
このプロパティは、実行時にテキストと色を変更できるかどうかを保持します。
true に設定する と 、 テ キ ス ト と 色は実行時に変更で き ます。
true に設定して QtSafeRenderer ファイルを生成すると、プロジェクトの動的なSafeText QML タイプで使用するフォントタイプごとに.qpf2ファイルが生成されます。
デフォルトでは、false に設定され、.srbファイルが生成されます。
text : string |
このプロパティは表示するテキストを保持します。このプロパティは、runtimeEditable がtrue に設定されていれば、実行時に変更することができます。
verticalAlignment : VAlignment |
このプロパティは、SafeText の高さ内でのテキストの垂直アライメントを保持します。垂直アライメントは、テキストの自然なアライメントに従います。
注: このプロパティは、実行時に変更することはできません。
width : real |
このプロパティはテキスト項目の幅を保持する。デフォルト値は128 です。
注意 :項目領域が小さすぎる場合、テキストは切り取られます。
注 :項目の最大幅は元の幅である。
注 :項目が Qt Safe Renderer.
wrapMode : WrapMode |
このプロパティは、テキストがどのように折り返されるかを保持する。テキストは、明示的な幅が設定されている場合にのみ折り返される。
注意: このプロパティは実行時に変更することはできません。
x : real |
このプロパティは、テキストのx座標位置を保持します。
y : real |
このプロパティは、テキストの y 座標位置を保持します。
特定の Qt ライセンスの下で利用可能です。
詳細はこちら。