SafeText QML Type

Qt Safe Renderer の出力検証を使用して検証可能な、安全上重要なQMLテキスト型を提供します。詳細...

• 継承されたメンバーを含む、すべてのメンバーの一覧

列挙型

• HAlignment
• VAlignment
• WrapMode

プロパティ

• 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 SafeTextアイテム用のフォントデータを生成するQt Safe Layout Toolを提供します。Qt Safe Renderer による出力検証により、表示内容から安全なアイテムの整合性を確保できます。

重要な考慮事項

• Qt Quick Ultralite Safe Renderer モジュールは、Static または Spark フォントエンジンに依存しない、カスタムテキストレイアウトパイプラインを使用しています。
• xml-ph-0000@deepl.internal 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 項目と一致する文字列でなければなりません。

関連項目： Qt Quick 安全上重要な項目を含むUltraliteアプリケーション。

列挙型のドキュメント

HAlignment

アライメントオプションの一覧を表示します。

VAlignment

テキストを縦方向に揃えるためのオプションの一覧を提供します。

WrapMode

テキストの折り返しに関するオプションの一覧を提供します。

プロパティのドキュメント

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

フォントのファミリー名を設定します。

font.italic : bool

このプロパティは、フォントスタイルがイタリックかどうかを示します。

font.pixelSize : int

このプロパティは、フォントサイズをピクセル単位で保持します。

height : real

このプロパティは、テキスト項目の高さを保持します。デフォルト値は64 です。

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 です。

wrapMode : WrapMode [default]

このプロパティは、テキストの折り返し方法を指定します。テキストが折り返されるのは、明示的な幅が設定されている場合のみです。

x : real

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

y : real

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

特定のQtライセンスの下で利用可能です。
詳細はこちらをご覧ください。