Back to Qt.io
Contact Us Blog Download Qt
このページでは

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

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

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

次の コ ー ド は、 16 進記法を用いて定義 さ れた緑色のテ キ ス ト 色の例を示 し ます：

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

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

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

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 ファイルを生成すると、プロジェクトの dynamicSafeText QML タイプで使用するフォントタイプごとに.qpf2ファイルが生成されます。

デフォルトでは、false に設定され、.srbファイルが生成されます。

text : string

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

verticalAlignment : VAlignment

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

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

width : real

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

注意 ：アイテム領域が小さすぎる場合、テキストは切り取られます。

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

注 ：このプロパティは、アイテムが Qt Safe Renderer.

wrapMode : WrapMode [default]

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

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

x : real

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

y : real

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

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