このページでは

C

SafeText QML Type

Qt Safe Renderer の出力検証を使って検証できるセーフティクリティカルな QML テキスト型を提供します。詳細...

Import Statement: import QtQuickUltralite.SafeRenderer
Since: Qt Quick Ultralite 2.9

列挙

プロパティ

詳細説明

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) 文字のみがサポートされます。

runtimeEditabletrue に設定すると、テキストを実行時に変更できます。

次のコードは、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単語境界でテキストを折り返す。

注意: runtimeEditabletrue に設定されている場合、SafeText ではSafeText.WordWrap はサポートされません。

定数説明
SafeText.WrapAnywhere行の任意の位置でテキストを折り返します。
SafeText.Wrap可能であれば、単語境界でテキストを折り返します。そうでない場合は、単語の途中であっても、行の適切な位置でテキストを折り返します。

プロパティの説明

color : color

このプロパティはテキストの色を保持する。runtimeEditabletrue に設定すると、実行時に変更できます。

次のコードは、16進数表記で定義された緑のテキスト色の例です:

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

次の コ ー ド は、 SVG カ ラ ー名を用いて定義 さ れた ス チ ールブルーのテ キ ス ト 色の例を示 し ます:

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

fillColor : color

こ のプ ロ パテ ィ はテ キ ス ト の背景塗 り 色を保持 し ます。こ れは、runtimeEditabletrue に設定す る と 、 実行時に変更で き ます。


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

このプロパティは表示するテキストを保持します。このプロパティは、runtimeEditabletrue に設定されていれば、実行時に変更することができます。


verticalAlignment : VAlignment

このプロパティは、SafeText の高さ内でのテキストの垂直アライメントを保持します。垂直アライメントは、テキストの自然なアライメントに従います。

注: このプロパティは、実行時に変更することはできません。


width : real

このプロパティはテキスト項目の幅を保持する。デフォルト値は128 です。

注意 :項目領域が小さすぎる場合、テキストは切り取られます。

:項目の最大幅は元の幅である。

:項目が Qt Safe Renderer.


wrapMode : WrapMode [default]

このプロパティは、テキストがどのように折り返されるかを保持する。テキストは、明示的な幅が設定されている場合にのみ折り返される。

注意: このプロパティは実行時に変更することはできません。


x : real

このプロパティは、テキストのx座標位置を保持します。


y : real

このプロパティは、テキストの y 座標位置を保持します。


特定の Qt ライセンスの下で利用可能です。
詳細はこちら。