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()も参照してください 。