TextMetrics QML Type

指定されたフォントとテキストに関するメトリクスを提供します。詳細...

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

プロパティ

• advanceWidth : real
• boundingRect : rect
• elide : enumeration
• elideWidth : real
• elidedText : string
• font : font
• height : real
• renderType : enumeration (since 6.3)
• text : string
• tightBoundingRect : rect
• width : real

詳細説明

TextMetricsは、特定のフォントについて、指定されたテキスト文字列のさまざまな特性を計算します。

これは、引数を取るQFontMetricsF 内の関数に対して、宣言型 API を提供します。

TextMetrics {
    id: textMetrics
    font.family: "Arial"
    elide: Text.ElideMiddle
    elideWidth: 100
    text: "Hello World"
}

MyItem {
    text: textMetrics.elidedText
}

QFontMetricsF およびFontMetricsも参照してください 。

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

advanceWidth : real [read-only]

このプロパティは、text 内の文字のピクセル単位の進み量を保持します。これは、文字列の位置から、次の文字列が描画されるべき位置までの距離です。

QFontMetricsF::horizontalAdvance()も参照してください 。

boundingRect : rect [read-only]

このプロパティは、text で指定された文字列に含まれる文字の境界矩形を保持します。

QFontMetricsF::boundingRect() およびtightBoundingRectも参照してください 。

elide : enumeration

このプロパティは、テキストの省略モードを保持します。これにより、文字列が省略される位置が決まります。取り得る値は以下の通りです：

関連項目： elideWidth およびQFontMetrics::elidedText 。

elideWidth : real

このプロパティは、テキストが省略されるようになるまでの最大幅（ピクセル単位）を指定します。

「 elide 」および「QFontMetrics::elidedText 」も参照してください 。

elidedText : string [read-only]

文字列text の幅がelideWidth より広い場合、このプロパティには省略された形式の文字列（つまり、「...」を含む文字列）が格納されます。テキストの幅がelideWidth 以下である場合、またはelide がQt::ElideNone に設定されている場合、このプロパティは元の文字列と同じ値になります。

QFontMetricsF::elidedText()も参照してください 。

font : font

このプロパティには、メトリクスの計算に使用されるフォントが格納されます。

height : real [read-only]

このプロパティは、text で指定された文字列に含まれる文字のバウンディング矩形の高さを保持します。これは、以下の記述と同等です。

textMetrics.boundingRect.height

「boundingRect」も参照してください 。

renderType : enumeration [since 6.3]

このコンポーネントのデフォルトのレンダリングタイプを上書きします。

サポートされているレンダリングタイプは以下の通りです：

これは、テキストを描画する対象のrenderType と一致している必要があります。

このプロパティは Qt 6.3 で導入されました。

「Text.renderType」も参照してください 。

text : string

このプロパティには、メトリクスの計算に使用されるテキストが格納されます。

tightBoundingRect : rect [read-only]

このプロパティは、text で指定された文字列内の文字を囲む、きつい境界矩形を保持します。

QFontMetricsF::tightBoundingRect() およびboundingRectも参照してください 。

width : real [read-only]

このプロパティは、text で指定された文字列内の文字のバウンディング矩形の幅を保持します。これは、以下と同等です。

textMetrics.boundingRect.width

「boundingRect」も参照してください 。