QFontVariableAxis Class
QFontVariableAxis クラスは、フォント内の可変軸を表します。詳細...
| ヘッダー: | #include <QFontVariableAxis> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
| 以下のように: | Qt 6.9 |
- 継承されたメンバーを含むすべてのメンバーの一覧
- QFontVariableAxis は、暗黙的に共有されるクラス群の一部です。
注：このクラスのすべての関数は再入可能です。
プロパティ
|
公開関数
| QFontVariableAxis(const QFontVariableAxis &axis) | |
| QFontVariableAxis(QFontVariableAxis &&other) | |
| ~QFontVariableAxis() | |
| qreal | defaultValue() const |
| qreal | maximumValue() const |
| qreal | minimumValue() const |
| QString | name() const |
| void | setDefaultValue(qreal defaultValue) |
| void | setMaximumValue(qreal maximumValue) |
| void | setMinimumValue(qreal minimumValue) |
| void | setName(const QString &name) |
| void | setTag(QFont::Tag tag) |
| QFont::Tag | tag() const |
| QFontVariableAxis & | operator=(const QFontVariableAxis &axis) |
詳細な説明
可変フォントは、1つのフォントファイル内に複数のバリエーション（太さ、幅、スタイルが異なるもの）を格納する方法を提供します。これらのバリエーションは、「可変軸」と呼ばれる事前定義されたパラメータセットに対する浮動小数点値として指定されます。
特定のパラメータ設定（フォント内の軸に対する値のセット）は、独立したフォントファイルとして定義される従来のサブファミリーと同様に、QFont のプロパティを使用して選択できます。しかし、バリアブルフォントでは、各軸に任意の値を指定することで、フォントの外観をきめ細かくカスタマイズすることができます。
QFontVariableAxisには、1つの軸に関する情報が含まれています。QFontInfo::variableAxes() を使用すると、指定されたフォントに対して定義されている可変軸のリストを取得できます。QFont::setVariableAxis() を使用し、tag() を引数として渡すことで、軸ごとに特定の値を指定できます。
注： Windowsでは 、オプションの GDI フォントバックエンドが使用されている場合、可変軸はサポートされません。
プロパティのドキュメント
[read-only] defaultValue : const qreal
このプロパティには、軸のデフォルト値が格納されます
これは、QFont クエリで値が指定されていない場合に、軸に設定される値です。
アクセス関数:
| qreal | defaultValue() const |
minimumValue() およびmaximumValue()も参照してください 。
[read-only] maximumValue : const qreal
このプロパティは、軸の最大値を保持します
この値よりも大きい値を軸に設定することはサポートされていません。
アクセス関数：
| qreal | maximumValue() const |
関連項目： minimumValue() およびdefaultValue()。
[read-only] minimumValue : const qreal
このプロパティには、軸の最小値が格納されます。
アクセス関数：
| qreal | minimumValue() const |
[read-only] name : const QString
このプロパティには、フォントで指定されている場合、軸の名前が格納されます
アクセス関数：
| QString | name() const |
tag()も参照してください 。
[read-only] tag : const QByteArray
このプロパティは、軸のタグを保持します
これは、軸を識別するための4文字の文字列です。「wght」（重量）や「wdth」（幅）など、特定のタグには標準化された意味がありますが、Latin-1 形式の4文字からなる任意の文字列であれば、有効なタグとなります。慣例により、標準外またはカスタムの軸は、すべて大文字のタグで表されます。
QFont::setVariableAxis() およびname()も参照してください 。
メンバー関数のドキュメント
QFontVariableAxis::QFontVariableAxis(const QFontVariableAxis &axis)
指定されたaxis のコピーであるQFontVariableAxisオブジェクトを作成します。
operator=()も参照してください 。
[constexpr noexcept default] QFontVariableAxis::QFontVariableAxis(QFontVariableAxis &&other)
QFontVariableAxis のインスタンスをmove-constructで生成します。
[noexcept] QFontVariableAxis::~QFontVariableAxis()
この `QFontVariableAxis ` オブジェクトを破棄します。
qreal QFontVariableAxis::defaultValue() const
軸のデフォルト値を返します。これは、QFont クエリで値が指定されていない場合に、軸が持つ値です。
注： プロパティ defaultValueのゲッター 関数です 。
関連項目： setDefaultValue()、minimumValue()、maximumValue()。
qreal QFontVariableAxis::maximumValue() const
その軸の最大値を返します。この値よりも大きい値を軸に設定することはサポートされていません。
注： プロパティ maximumValueのゲッター 関数です 。
関連項目： setMaximumValue()、minimumValue()、およびdefaultValue()。
qreal QFontVariableAxis::minimumValue() const
その軸の最小値を返します。この値よりも小さい値を軸に設定することはサポートされていません。
注： プロパティ minimumValueのゲッター関数です 。
関連項目： setMinimumValue()、maximumValue()、およびdefaultValue()。
QString QFontVariableAxis::name() const
フォントによって指定されている場合、軸の名前を返します。
注： プロパティ nameのゲッター関数です 。
void QFontVariableAxis::setDefaultValue(qreal defaultValue)
このQFontVariableAxis のデフォルト値をdefaultValue に設定します。
注：通常 、この関数を呼び出す必要はありません。これは、フォント自体には影響を与えず、この特定の表現にのみ影響するからです。
defaultValue()も参照してください 。
void QFontVariableAxis::setMaximumValue(qreal maximumValue)
このQFontVariableAxis の最大値をmaximumValue に設定します。
注：通常 、この関数を呼び出す必要はありません。これは、フォント自体には影響を与えず、この特定の表現にのみ影響するためです。
maximumValue()も参照してください 。
void QFontVariableAxis::setMinimumValue(qreal minimumValue)
このQFontVariableAxis の最小値をminimumValue に設定します。
注：通常 、この関数を呼び出す必要はありません。これはフォント自体には影響せず、この特定の表現にのみ影響するためです。
minimumValue()も参照してください 。
void QFontVariableAxis::setName(const QString &name)
このQFontVariableAxis の名前をname に設定します。
注：通常 、この関数を呼び出す必要はありません。これはフォント自体には影響せず、この特定の表現にのみ影響するためです。
name()も参照してください 。
void QFontVariableAxis::setTag(QFont::Tag tag)
QFontVariableAxis のタグをtag に設定します。
注：通常 、この関数を呼び出す必要はありません。これはフォント自体には影響せず、この特定の表現にのみ影響するためです。
tag()も参照してください 。
QFont::Tag QFontVariableAxis::tag() const
軸のタグを返します。これは、軸を識別する4文字の文字列です。 「wght」（重量）や「wdth」（幅）など、特定のタグには標準化された意味がありますが、4文字のLatin-1文字の任意の文字列であれば有効なタグとなります。慣例により、非標準またはカスタム軸はすべて大文字のタグで表されます。
setTag()、QFont::setVariableAxis()、およびname()も参照してください 。
QFontVariableAxis &QFontVariableAxis::operator=(const QFontVariableAxis &axis)
指定されたaxis を、このQFontVariableAxis に割り当てます。
QFontVariableAxis()も参照してください 。
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.
