FontMetrics QML Type

与えられたフォントのメトリクスを提供します。詳細...

• 継承されたメンバを含む、すべてのメンバのリスト

プロパティ

• ascent : real
• averageCharacterWidth : real
• capitalHeight : real (since 6.9)
• descent : real
• font : font
• height : real
• leading : real
• lineSpacing : real
• lineWidth : real
• maximumCharacterWidth : real
• minimumLeftBearing : real
• minimumRightBearing : real
• overlinePosition : real
• strikeOutPosition : real
• underlinePosition : real
• xHeight : real

方法

• real advanceWidth(string text)
• rect boundingRect(string text)
• string elidedText(string text, enumeration mode, real width, int flags)
• rect tightBoundingRect(string text)

詳細説明

FontMetrics は、指定されたフォントの文字と文字列のサイズを計算します。

C++QFontMetricsF API のサブセットを提供し、font プロパティによって計算に使用するフォントを変更する機能が追加されています。

FontMetrics {
    id: fontMetrics
    font.family: "Arial"
}

Rectangle {
    width: fontMetrics.height * 4
    height: fontMetrics.height * 2
}

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

プロパティ・ドキュメンテーション

ascent : real [read-only]

このプロパティはフォントのアセントを保持する。

QFontMetricsF::ascent()、descent 、heightも参照のこと 。

averageCharacterWidth : real [read-only]

このプロパティはフォント内のグリフの平均幅を保持する。

QFontMetricsF::averageCharWidth()も参照のこと 。

capitalHeight : real [read-only, since 6.9]

フォントが指定する大文字の高さを返します。

フォントのキャップハイトとは、大文字のベースラインからの高さのことです。特に、O のような丸い文字や A のような尖った文字とは対照的に、H や I のような平らな大文字の高さを指します。

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

QFontMetricsF::capHeight,ascent,descent,height,xHeightも参照してください 。

descent : real [read-only]

このプロパティはフォントの下降を保持する。

QFontMetricsF::descent()、ascent 、heightも参照のこと 。

font : font

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

height : real [read-only]

このプロパティはフォントの高さを保持する。

QFontMetricsF::height()も参照 。

leading : real [read-only]

このプロパティはフォントの先頭を保持する。

QFontMetricsF::leading()も参照 。

lineSpacing : real [read-only]

このプロパティは、あるベースラインから次のベースラインまでの距離を保持する。

QFontMetricsF::lineSpacing()も参照 。

lineWidth : real [read-only]

このプロパティは、フォントのポイントサイズに合わせて調整された下線と取り消し線の幅を保持する。

QFontMetricsF::lineWidth()も参照 。

maximumCharacterWidth : real [read-only]

このプロパティは、フォントの中で最も幅の広い文字の幅を保持する。

QFontMetricsF::maxWidth()も参照 。

minimumLeftBearing : real [read-only]

このプロパティは、フォントの最小左ベアリングを保持する。

QFontMetricsF::minLeftBearing()も参照 。

minimumRightBearing : real [read-only]

このプロパティは、フォントの最小右ベアリングを保持する。

QFontMetricsF::minRightBearing()も参照 。

overlinePosition : real [read-only]

このプロパティは、ベースラインからオーバーラインを引くべき位置までの距離を保持する。

QFontMetricsF::overlinePos()、underlinePosition 、strikeOutPositionも参照 。

strikeOutPosition : real [read-only]

このプロパティは、ベースラインから三振線を引くべき位置までの距離を保持する。

QFontMetricsF::strikeOutPos()、overlinePosition 、underlinePositionも参照 。

underlinePosition : real [read-only]

このプロパティは、ベースラインからアンダースコアが描かれるべき位置までの距離を保持する。

QFontMetricsF::underlinePos()、overlinePosition 、strikeOutPositionも参照のこと 。

xHeight : real [read-only]

このプロパティは、フォントの「x」の高さを保持する。

QFontMetricsF::xHeight()も参照 。

メソッド・ドキュメント

real advanceWidth(string text)

このメソッドは、text の文字の進み具合をピクセル単位で返す。これは、文字列の位置から次の文字列が描画されるべき位置までの距離です。

このメソッドは、TextMetrics のadvanceWidth プロパティに代わる命令形として提供される。

QFontMetricsF::horizontalAdvance() およびQFontMetricsF::height()も参照 。

rect boundingRect(string text)

このメソッドは、text で指定された文字列内の文字の外接矩形を返す。

このメソッドは、TextMetrics のboundingRect プロパティに代わる命令形として提供されます。

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

string elidedText(string text, enumeration mode, real width, int flags)

このメソッドは、文字列text の幅がwidth よりも広い場合、その文字列のエライドバージョン（つまり、"..." が含まれる文字列）を返す。 そうでない場合は、元の文字列を返す。

mode 引数は、テキストのエライドモードを指定します。つまり、収まらないテキストを表示するときに、どこに省略記号を表示するかを指定します。

flags 引数はオプションで、現在はQt::TextShowMnemonic にのみ対応している。

このメソッドは、TextMetrics のelidedText プロパティに代わる命令形として提供されています。

Qt::TextElideMode およびQFontMetricsF::elidedText()も参照してください 。

rect tightBoundingRect(string text)

このメソッドは、text で指定された文字列の文字を囲むタイトな外接矩形を返す。

このメソッドは、TextMetrics のtightBoundingRect プロパティに代わる命令形として提供されています。

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