QFont Class
QFont クラスは、テキストの描画に使用されるフォントに対するクエリを指定します。詳細...
| ヘッダー: | #include <QFont> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| qmake: | QT += gui |
- 継承されたメンバーを含む、すべてのメンバーの一覧
- 非推奨のメンバ
- QFontは、描画クラス、暗黙的に共有されるクラス、およびリッチテキスト処理APIの一部です。
注:このクラスのすべての関数は再入可能です。
パブリック型
(since 6.7) struct | Tag |
| enum | Capitalization { MixedCase, AllUppercase, AllLowercase, SmallCaps, Capitalize } |
| enum | HintingPreference { PreferDefaultHinting, PreferNoHinting, PreferVerticalHinting, PreferFullHinting } |
| enum | SpacingType { PercentageSpacing, AbsoluteSpacing } |
| enum | Stretch { AnyStretch, UltraCondensed, ExtraCondensed, Condensed, SemiCondensed, …, UltraExpanded } |
| enum | Style { StyleNormal, StyleItalic, StyleOblique } |
| enum | StyleHint { AnyStyle, SansSerif, Helvetica, Serif, Times, …, System } |
| enum | StyleStrategy { PreferDefault, PreferBitmap, PreferDevice, PreferOutline, ForceOutline, …, PreferQuality } |
| enum | Weight { Thin, ExtraLight, Light, Normal, Medium, …, Black } |
パブリック関数
| QFont() | |
| QFont(const QFont &font, const QPaintDevice *pd) | |
| QFont(const QString &family, int pointSize = -1, int weight = -1, bool italic = false) | |
| QFont(const QStringList &families, int pointSize = -1, int weight = -1, bool italic = false) | |
| QFont(const QFont &font) | |
| QFont(QFont &&) | |
| ~QFont() | |
| bool | bold() const |
| QFont::Capitalization | capitalization() const |
(since 6.7) void | clearFeatures() |
(since 6.7) void | clearVariableAxes() |
| QString | defaultFamily() const |
| bool | exactMatch() const |
| QStringList | families() const |
| QString | family() const |
(since 6.7) QList<QFont::Tag> | featureTags() const |
(since 6.7) quint32 | featureValue(QFont::Tag tag) const |
| bool | fixedPitch() const |
| bool | fromString(const QString &descrip) |
| QFont::HintingPreference | hintingPreference() const |
| bool | isCopyOf(const QFont &f) const |
(since 6.7) bool | isFeatureSet(QFont::Tag tag) const |
(since 6.7) bool | isVariableAxisSet(QFont::Tag tag) const |
| bool | italic() const |
| bool | kerning() const |
| QString | key() const |
| qreal | letterSpacing() const |
| QFont::SpacingType | letterSpacingType() const |
| bool | overline() const |
| int | pixelSize() const |
| int | pointSize() const |
| qreal | pointSizeF() const |
| QFont | resolve(const QFont &other) const |
| void | setBold(bool enable) |
| void | setCapitalization(QFont::Capitalization caps) |
| void | setFamilies(const QStringList &families) |
| void | setFamily(const QString &family) |
(since 6.7) void | setFeature(QFont::Tag tag, quint32 value) |
| void | setFixedPitch(bool enable) |
| void | setHintingPreference(QFont::HintingPreference hintingPreference) |
| void | setItalic(bool enable) |
| void | setKerning(bool enable) |
| void | setLetterSpacing(QFont::SpacingType type, qreal spacing) |
| void | setOverline(bool enable) |
| void | setPixelSize(int pixelSize) |
| void | setPointSize(int pointSize) |
| void | setPointSizeF(qreal pointSize) |
| void | setStretch(int factor) |
| void | setStrikeOut(bool enable) |
| void | setStyle(QFont::Style style) |
| void | setStyleHint(QFont::StyleHint hint, QFont::StyleStrategy strategy = PreferDefault) |
| void | setStyleName(const QString &styleName) |
| void | setStyleStrategy(QFont::StyleStrategy s) |
| void | setUnderline(bool enable) |
(since 6.7) void | setVariableAxis(QFont::Tag tag, float value) |
| void | setWeight(QFont::Weight weight) |
| void | setWordSpacing(qreal spacing) |
| int | stretch() const |
| bool | strikeOut() const |
| QFont::Style | style() const |
| QFont::StyleHint | styleHint() const |
| QString | styleName() const |
| QFont::StyleStrategy | styleStrategy() const |
| void | swap(QFont &other) |
| QString | toString() const |
| bool | underline() const |
(since 6.7) void | unsetFeature(QFont::Tag tag) |
(since 6.7) void | unsetVariableAxis(QFont::Tag tag) |
(since 6.7) QList<QFont::Tag> | variableAxisTags() const |
(since 6.7) float | variableAxisValue(QFont::Tag tag) const |
| QFont::Weight | weight() const |
| qreal | wordSpacing() const |
| operator QVariant() const | |
| bool | operator!=(const QFont &f) const |
| bool | operator<(const QFont &f) const |
| QFont & | operator=(QFont &&other) |
| QFont & | operator=(const QFont &font) |
| bool | operator==(const QFont &f) const |
静的パブリックメンバー
| void | insertSubstitution(const QString &familyName, const QString &substituteName) |
| void | insertSubstitutions(const QString &familyName, const QStringList &substituteNames) |
| void | removeSubstitutions(const QString &familyName) |
| QString | substitute(const QString &familyName) |
| QStringList | substitutes(const QString &familyName) |
| QStringList | substitutions() |
関連する非メンバー
| size_t | qHash(const QFont &key, size_t seed = 0) |
| QDataStream & | operator<<(QDataStream &s, const QFont &font) |
| QDataStream & | operator>>(QDataStream &s, QFont &font) |
詳細説明
QFontは、システム上の1つまたは複数のフォントに対するクエリとみなすことができます。
QFont オブジェクトを作成する際には、そのフォントに持たせたいさまざまな属性を指定します。 Qt は、指定された属性を持つフォントを使用します。一致するフォントが存在しない場合は、Qt はインストールされているフォントの中から最も近いものを使用します。実際に使用されるフォントの属性は、QFontInfo オブジェクトから取得できます。ウィンドウシステムが完全に一致するフォントを提供している場合、exactMatch() はtrue を返します。QFontMetricsF を使用して寸法を取得します。例えば、QFontMetrics::horizontalAdvance() を使用して文字列のピクセル長を取得します。
明示的に設定されていない属性は、フォント選択アルゴリズムに影響を与えず、代わりにデフォルト値が優先されます。
特定の物理フォント(通常は単一のファイルで表される)を読み込むには、代わりにQRawFont を使用してください。
なお、QFont を使用するには、事前に `QGuiApplication ` インスタンスが存在している必要があります。アプリケーションのデフォルトフォントは、QGuiApplication::setFont() を使用して設定できます。
選択したフォントに表示に必要な文字がすべて含まれていない場合、QFontは最も近い代替フォントからその文字を探そうとします。QPainter がフォントから文字を描画する際、QFontはその文字の有無を報告します。もしその文字がない場合、QPainter は塗りつぶされていない四角形を描画します。
QFontは次のように作成します:
コンストラクタで設定された属性は、後で設定することも可能です(例:setFamily()、setPointSize()、setPointSizeF()、setWeight()、setItalic())。残りの属性は、インスタンス生成後に設定する必要があります(例:setBold()、setUnderline()、setOverline()、setStrikeOut()、setFixedPitch())。QFontInfo オブジェクトは、フォントの属性が設定された後に作成する必要があります。QFontInfo オブジェクトは、フォントの属性を変更しても変化しません。対応する「get」関数(例:family()、pointSize()など)は、実際に使用されている値が異なっていても、設定された値を返します。実際の値は、QFontInfo オブジェクトから取得できます。
要求されたフォントファミリーが利用できない場合、setStyleHint() を使用して特定のQFont::StyleHint およびQFont::StyleStrategy を選択することで、font matching algorithm に影響を与えることができます。デフォルトのファミリー(現在のスタイルヒントに対応するもの)は、defaultFamily() によって返されます。
insertSubstitution() およびinsertSubstitutions() を使用して、フォントファミリー名の置換を設定できます。置換はremoveSubstitutions() で解除できます。substitute() を使用すると、ファミリーの最初の置換を取得できます。置換がない場合は、ファミリー名そのものが返されます。substitutes() を使用すると、ファミリーの置換のリスト(空の場合もあります)を取得できます。 フォントの置換を行った後は、すべての QFont オブジェクトを破棄して再作成することで、フォントの更新をトリガーする必要があります。
すべての QFont にはkey() があり、これを例えばキャッシュや辞書のキーとして使用できます。ユーザーのフォント設定を保存したい場合は、QSettings を使用し、toString() でフォント情報を書き込み、fromString() で読み戻すことができます。operator<<() および operator>>() 関数も利用可能ですが、これらはデータストリーム上で動作します。
setPixelSize() を使用すると、画面に表示される文字の高さを指定したピクセル数に設定できます。ただし、setPointSize() を使用しても同様の効果が得られ、デバイスに依存しない処理が可能になります。
フォントの読み込みは、特にX11上では負荷が高くなりがちです。QFontには、QFontオブジェクトのコピーを高速化し、依存する処理の遅いウィンドウシステム関数の結果をキャッシュするための、広範な最適化が施されています。
フォントマッチングアルゴリズムは次のように動作します:
- 指定されたフォントファミリー(setFamilies() で設定)が検索されます。
- 見つからない場合は、その文字体系をサポートする代替フォントが選択されます。フォントマッチングアルゴリズムは、QFontで設定されたすべてのプロパティに対して最適なフォントを見つけようとします。その方法はプラットフォームによって異なります。
- システム上にそのテキストをサポートできるフォントが存在しない場合、その場所に特別な「欠落文字」ボックスが表示されます。
注: 選択されたフォントが、その文字体系を概ねサポートしているものの、1つ以上の特定の文字のグリフが欠落している場合 、Qtはその特定の文字に対するフォールバックフォントを検索しようとします。この機能は、QFont::NoFontMerging スタイル戦略を使用して無効にすることができます。
Windows では、「Courier」フォントへの要求は自動的に「Courier New」に変更されます。これは、スムーズなスケーリングを可能にする Courier の改良版です。古い「Courier」ビットマップフォントは、PreferBitmap スタイル戦略を設定することで選択できます(setStyleStrategy() を参照)。
フォントが見つかった後、残りの属性は優先順に従って照合されます:
- fixedPitch()
- pointSize()(以下を参照)
- weight()
- style()
フォントファミリーが一致するフォントがある場合、他の属性が一切一致していなくても、フォントファミリーは一致しないが他の属性は一致するフォントよりも、このフォントが優先的に選択されます。これは、フォントファミリーが最優先の検索条件であるためです。
ポイントサイズは、要求されたポイントサイズから±20%の範囲内であれば一致すると定義されます。複数のフォントが一致し、ポイントサイズのみで区別される場合、要求されたポイントサイズに最も近いフォントが選択されます。
テキストの描画に使用される実際のフォントファミリー、フォントサイズ、ウェイト、およびその他のフォント属性は、ウィンドウシステム上で選択されたフォントファミリーに対して利用可能なものによって異なります。QFontInfo オブジェクトを使用することで、テキストの描画に使用される実際の値を特定することができます。
例:
QFont f("Helvetica");Adobe製とCronyx製のHelveticaの両方がインストールされている場合、どちらかが使用される可能性があります。
QFont f("Helvetica [Cronyx]");ファミリー名に希望のフォントメーカーを指定することができます。上記の例にあるフォント「f」は、「Helvetica [Cronyx]」として設定されます。
ウィンドウシステムで実際に使用されているフォントの属性を確認するには、QFontInfo オブジェクトを使用します。例:
フォントのメトリクスを調べるには、QFontMetrics オブジェクトを使用します。例:
QFontMetrics fm(f1);
int textWidthInPixels = fm.horizontalAdvance("How many pixels wide is this text?");
int textHeightInPixels = fm.height();フォントに関するより一般的な情報については、comp.fontsのFAQを参照してください。エンコーディングに関する情報は、UTR17のページで確認できます。
QFontMetrics 、QFontInfo 、およびQFontDatabaseも参照してください 。
メンバ型のドキュメント
enum QFont::Capitalization
このフォントが適用されるテキストのレンダリングオプション。
| 定数 | 値 | 説明 |
|---|---|---|
QFont::MixedCase | 0 | これは、大文字・小文字の変更が適用されない通常のテキスト描画オプションです。 |
QFont::AllUppercase | 1 | これは、テキストをすべて大文字でレンダリングするように変更します。 |
QFont::AllLowercase | 2 | これにより、テキストはすべて小文字でレンダリングされます。 |
QFont::SmallCaps | 3 | これにより、テキストはスモールキャップスでレンダリングされます。 |
QFont::Capitalize | 4 | これにより、各単語の最初の文字が大文字になるようにテキストがレンダリングされます。 |
enum QFont::HintingPreference
この列挙型は、ピクセル密度によって必要とされる場合、ディスプレイ上での可読性を向上させるためにグリフに適用できるさまざまなレベルのヒンティングを表します。
| 定数 | 値 | 説明 |
|---|---|---|
QFont::PreferDefaultHinting | 0 | ターゲットプラットフォームのデフォルトのヒンティングレベルを使用します。 |
QFont::PreferNoHinting | 1 | 可能であれば、グリフのアウトラインにヒンティングを適用せずにテキストをレンダリングします。テキストのレイアウトは、たとえば印刷時と同じメトリクスを使用することで、活字組版的に正確でスケーラブルなものになります。 |
QFont::PreferVerticalHinting | 2 | 可能であれば、水平方向のヒンティングを行わずにテキストをレンダリングし、垂直方向ではグリフをピクセルグリッドに揃えます。 ディスプレイの密度が低すぎてグリフを正確にレンダリングできない場合、テキストはより鮮明に表示されます。しかし、グリフの水平メトリックにはヒンティングが適用されていないため、改行などの詳細に影響を与えることなく、高密度のデバイス(プリンターなど)でもテキストのレイアウトをスケーラブルにすることができます。 |
QFont::PreferFullHinting | 3 | 可能であれば、水平方向と垂直方向の両方でヒンティングを適用してテキストをレンダリングしてください。 テキストはターゲットデバイスでの可読性を最適化するために変更されますが、メトリクスはテキストのターゲットサイズに依存するため、グリフの位置、改行、その他の組版上の詳細はスケーリングされません。つまり、ピクセル密度の異なるデバイスでは、テキストのレイアウトが異なって見える可能性があります。 |
Qt がサポートするすべてのプラットフォームで、ヒントレベルの全範囲がサポートされているわけではないため、この列挙型はあくまで設定の好みを表すものであることにご注意ください。以下の表は、特定のヒント設定が、選択されたターゲットプラットフォーム群に及ぼす影響を詳しく示したものです。
| PreferDefaultHinting | PreferNoHinting | PreferVerticalHinting | PreferFullHinting | |
|---|---|---|---|---|
| QtでWindowsおよびDirectWriteが有効な場合 | 完全なヒント機能 | 縦方向のヒンティング | 縦方向のヒンティング | 完全なヒンティング |
| FreeType | OSの設定 | ヒントなし | 縦方向のヒンティング(軽め) | 完全なヒンティング |
| macOS上のCocoa | ヒンティングなし | ヒンティングなし | ヒントなし | ヒンティングなし |
enum QFont::SpacingType
| 定数 | 値 | 説明 |
|---|---|---|
QFont::PercentageSpacing | 0 | 値が 100 の場合、文字間隔は変更されません。値が 200 の場合、文字の後の間隔が、その文字自体の幅分だけ広がります。 |
QFont::AbsoluteSpacing | 1 | 正の値は文字間隔をその値に相当するピクセル分広げ、負の値は間隔を狭めます。 |
enum QFont::Stretch
CSSの命名規則に従った、あらかじめ定義されたストレッチ値。値が大きいほど、テキストはより引き伸ばされます。
| 定数 | 値 | 説明 |
|---|---|---|
QFont::AnyStretch (since Qt 5.8) | 0 | 0 他のQFont プロパティで指定されたストレッチ値に一致するものはすべて受け入れる |
QFont::UltraCondensed | 50 | 50 |
QFont::ExtraCondensed | 62 | 62 |
QFont::Condensed | 75 | 75 |
QFont::SemiCondensed | 87 | 87 |
QFont::Unstretched | 100 | 100 |
QFont::SemiExpanded | 112 | 112 |
QFont::Expanded | 125 | 125 |
QFont::ExtraExpanded | 150 | 150 |
QFont::UltraExpanded | 200 | 200 |
setStretch() およびstretch()も参照してください 。
enum QFont::Style
この列挙型は、テキストの表示に使用されるさまざまなグリフのスタイルを表します。
| 定数 | 値 | 説明 |
|---|---|---|
QFont::StyleNormal | 0 | スタイルが適用されていないテキストで使用される通常のグリフ。 |
QFont::StyleItalic | 1 | イタリック体のテキストを表現するために特別にデザインされたイタリックグリフ。 |
QFont::StyleOblique | 2 | 通常はスタイルが適用されていないグリフを基にしているが、イタリック体のテキストを表すために微調整はされていない、イタリック風の外観を持つグリフ。 |
「Weight」も参照してください 。
enum QFont::StyleHint
スタイルヒントは、選択されたフォントファミリーが利用できない場合に、font matching アルゴリズムが適切なデフォルトのフォントファミリーを見つけるために使用されます。
| 定数 | 値 | 説明 |
|---|---|---|
QFont::AnyStyle | 5 | フォントマッチングアルゴリズムにファミリーの選択を委ねます。これがデフォルトです。 |
QFont::SansSerif | Helvetica | フォントマッチングアルゴリズムは、サンセリフフォントを優先します。 |
QFont::Helvetica | 0 | SansSerif の同義語です。 |
QFont::Serif | Times | フォントマッチャーはセリフ書体を優先します。 |
QFont::Times | 1 | Serif の同義語です。 |
QFont::TypeWriter | Courier | フォントマッチャーは等幅フォントを優先します。 |
QFont::Courier | 2 | TypeWriter の同義語です。 |
QFont::OldEnglish | 3 | フォントマッチャーは装飾フォントを優先します。 |
QFont::Decorative | OldEnglish | OldEnglish の同義語です。 |
QFont::Monospace | 7 | フォントマッチャーは、CSSの汎用フォントファミリー「monospace」にマッピングされるフォントを優先します。 |
QFont::Fantasy | 8 | フォントマッチャーは、CSS の汎用フォントファミリー「fantasy」にマッピングされるフォントを優先します。 |
QFont::Cursive | 6 | フォントマッチャーは、CSS の汎用フォントファミリー「cursive」にマッピングされるフォントを優先します。 |
QFont::System | 4 | フォントマッチャーは、システムフォントを優先します。 |
enum QFont::StyleStrategy
スタイル戦略は、font matching アルゴリズムに対し、適切なデフォルトフォントファミリーを見つけるためにどの種類のフォントを使用すべきかを指示します。
以下の戦略が利用可能です:
| 定数 | 値 | 説明 |
|---|---|---|
QFont::PreferDefault | 0x0001 | デフォルトのスタイル戦略です。特定のフォントタイプを優先しません。 |
QFont::PreferBitmap | 0x0002 | ビットマップフォントを優先します(アウトラインフォントとは対照的です)。 |
QFont::PreferDevice | 0x0004 | デバイスフォントを優先します。 |
QFont::PreferOutline | 0x0008 | アウトラインフォントを優先します(ビットマップフォントとは対照的)。アウトラインフォントの使用を強制します。 |
QFont::ForceOutline | 0x0010 | アウトラインフォントの使用を強制します。 |
QFont::NoAntialias | 0x0100 | フォントのアンチエイリアシングを行わない。 |
QFont::NoSubpixelAntialias | 0x0800 | 可能であれば、フォントのサブピクセルアンチエイリアシングを回避します。 |
QFont::PreferAntialias | 0x0080 | 可能であればアンチエイリアス処理を行う。 |
QFont::ContextFontMerging (since Qt 6.8) | 0x2000 | 選択したフォントに特定の文字が含まれていない場合、Qt はその文字を含む、見た目が似ているフォントを自動的に代替フォントとして選択します。デフォルトでは、これは文字単位で行われます。つまり、ごくまれなケースでは、同じ文字体系であっても、1 つの文字列を表現するために複数のフォントが使用されることがあります。ContextFontMerging を設定すると、代わりに、入力文字列の最大の部分集合に一致するフォールバックフォントが検索されるようになります。これにより、欠落したグリフが存在する文字列では処理負荷が高くなりますが、より一貫性のある結果が得られる可能性があります。NoFontMerging が設定されている場合、ContextFontMerging は効果を持ちません。 |
QFont::PreferTypoLineMetrics (since Qt 6.8) | 0x4000 | 互換性の理由から、OpenTypeフォントには、フォントのascent 、descent 、およびleading を提供する、2組の競合する縦線メトリクスが含まれています。これらは、しばしばwin(Windows)メトリクスとtypo(タイポグラフィ)メトリクスと呼ばれます。 仕様では行間隔にtypo メトリクスの使用が推奨されていますが、多くのアプリケーションは、フォントのfsSelectionフィールドで USE_TYPO_METRICS フラグが設定されていない限り、win メトリクスを優先します。下位互換性の理由から、Qtアプリケーションでも同様の挙動となります。 これは、USE_TYPO_METRICS フラグを設定してtypo メトリクスが有効であることを示しているフォントや、win メトリクスとtypo メトリクスが一致しているフォントについては問題になりません。しかし、特定のフォントでは、win メトリクスが望ましい行間よりも大きくなり、USE_TYPO_METRICS フラグが誤って設定されていない場合があります。そのようなフォントの場合、PreferTypoLineMetrics を設定することで、より良い結果が得られることがあります。 |
QFont::NoFontMerging | 0x8000 | 特定の文字体系用に選択されたフォントに、描画を要求された文字が含まれていない場合、Qtはその文字を含む、見た目が類似したフォントを自動的に選択します。NoFontMergingフラグを有効にすると、この機能が無効になります。なお、このフラグを有効にしても、選択されたフォントがテキストの文字体系に対応していない場合、Qtが自動的に適切なフォントを選択することを防ぐことはできません。 |
QFont::PreferNoShaping | 0x1000 | フォントによっては、文字を正しく表示するために、一連の文字に対して複雑なルールを適用する場合があります。ブラフミック文字体系などの一部の文字体系では、テキストを読みやすくするためにこれが必須ですが、例えばラテン文字体系では、これは単なる装飾的な機能に過ぎません。 PreferNoShapingフラグを指定すると、必要のない場合にこうした機能をすべて無効にすることができ、ほとんどの場合、パフォーマンスが向上します(Qt 5.10以降)。 |
これらのフラグのいずれかには、以下のフラグのいずれかと OR 演算を適用できます:
| 定数 | 値 | 説明 |
|---|---|---|
QFont::PreferMatch | 0x0020 | 完全一致を優先します。フォントマッチャーは、指定されたフォントサイズと完全に一致するサイズを使用しようとします。 |
QFont::PreferQuality | 0x0040 | 最高品質のフォントを優先します。フォントマッチャーは、そのフォントがサポートする最も近い標準ポイントサイズを使用します。 |
enum QFont::Weight
Qtでは、OpenTypeと互換性のある1から1000までのウェイトスケールを使用しています。ウェイトが1の場合は細字となり、1000の場合は非常に太字になります。
この列挙型には、あらかじめ定義されたフォントのウェイトが含まれています:
| 定数 | 値 | 説明 |
|---|---|---|
QFont::Thin | 100 | 100 |
QFont::ExtraLight | 200 | 200 |
QFont::Light | 300 | 300 |
QFont::Normal | 400 | 400 |
QFont::Medium | 500 | 500 |
QFont::DemiBold | 600 | 600 |
QFont::Bold | 700 | 700 |
QFont::ExtraBold | 800 | 800 |
QFont::Black | 900 | 900 |
メンバ関数のドキュメント
QFont::QFont()
アプリケーションのデフォルトフォントを使用するフォントオブジェクトを作成します。
QGuiApplication::setFont() およびQGuiApplication::font()も参照してください 。
QFont::QFont(const QFont &font, const QPaintDevice *pd)
font から、ペイントデバイスpd で使用するためのフォントを生成します。
QFont::QFont(const QString &family, int pointSize = -1, int weight = -1, bool italic = false)
指定されたfamily 、pointSize 、weight 、およびitalic の設定でフォントオブジェクトを作成します。
pointSize が0または負の値の場合、フォントのポイントサイズはシステム依存のデフォルト値に設定されます。通常、これは12ポイントです。
family の名前には、オプションでフォントメーカー名を含めることもできます(例: "Helvetica [Cronyx]")。family が複数のフォントメーカーから入手可能であり、かつフォントメーカーが指定されていない場合、任意のフォントメーカーが選択されます。そのファミリーが利用できない場合は、font matching アルゴリズムを使用してファミリーが設定されます。
これにより、ファミリー文字列がコンマで分割され、その結果得られたリストを用いてsetFamilies() が呼び出されます。名前にコンマを含むフォントを保持するには、QStringList を引数とするコンストラクタを使用してください。
関連項目: Weight 、setFamily()、setPointSize()、setWeight()、setItalic()、setStyleHint()、setFamilies()、およびQGuiApplication::font()。
[explicit] QFont::QFont(const QStringList &families, int pointSize = -1, int weight = -1, bool italic = false)
指定されたfamilies 、pointSize 、weight 、およびitalic の設定を用いて、フォントオブジェクトを作成します。
pointSize が0または負の値の場合、フォントのポイントサイズはシステム依存のデフォルト値に設定されます。通常、これは12ポイントです。
families 内の各ファミリー名のエントリには、オプションでフォントメーカー名を含めることもできます(例: "Helvetica [Cronyx]")。 そのフォントファミリーが複数のフォントメーカーから提供されており、かつフォントメーカーが指定されていない場合、任意のフォントメーカーが選択されます。そのフォントファミリーが利用できない場合は、font matching アルゴリズムを使用してフォントファミリーが設定されます。
関連項目: Weight 、setPointSize()、setWeight()、setItalic()、setStyleHint()、setFamilies()、およびQGuiApplication::font()。
QFont::QFont(const QFont &font)
font のコピーとなるフォントを作成します。
[constexpr noexcept default] QFont::QFont(QFont &&)
QFont のインスタンスをMoveコンストラクタで生成します。
[noexcept] QFont::~QFont()
フォントオブジェクトを破棄し、割り当てられたすべてのリソースを解放します。
bool QFont::bold() const
weight() の値がQFont::Medium より大きい場合、true を返します。それ以外の場合は、false を返します。
weight()、setBold()、およびQFontInfo::bold()も参照してください 。
QFont::Capitalization QFont::capitalization() const
フォントの現在の大文字小文字の区別タイプを返します。
setCapitalization()も参照してください 。
[since 6.7] void QFont::clearFeatures()
QFont に以前に設定されていた機能をすべてクリアします。
フォント機能の詳細については、setFeature() を参照してください。
この関数は Qt 6.7 で導入されました。
QFont::Tag 、setFeature()、unsetFeature()、featureTags()、およびfeatureValue()も参照してください 。
[since 6.7] void QFont::clearVariableAxes()
QFont で以前に設定された変数軸の値をすべてクリアします。
可変軸の詳細については、setVariableAxis() を参照してください。
この関数は Qt 6.7 で導入されました。
QFont::Tag 、setVariableAxis()、unsetVariableAxis()、isVariableAxisSet()、およびvariableAxisValue()も参照してください 。
QString QFont::defaultFamily() const
現在のスタイルヒントに対応するファミリー名を返します。
StyleHint 、styleHint()、およびsetStyleHint()も参照してください 。
bool QFont::exactMatch() const
このフォントの設定と完全に一致するウィンドウシステムのフォントが利用可能な場合、true を返します。
QFontInfoも参照してください 。
QStringList QFont::families() const
要求されたフォントファミリー名、すなわち、前回のsetFamilies()の呼び出しまたはコンストラクタを通じて設定された名前を返します。それ以外の場合は、空のリストを返します。
setFamily()、setFamilies()、family()、substitutes()、およびsubstitute()も参照してください 。
QString QFont::family() const
指定されたフォントファミリー名を返します。これは常に、families() の呼び出しにおける最初のエントリと同じになります。
関連項目: setFamily()、substitutes()、substitute()、setFamilies()、およびfamilies()。
[since 6.7] QList<QFont::Tag> QFont::featureTags() const
このQFont に現在設定されているすべてのフォント機能のタグのリストを返します。
フォント機能の詳細については、setFeature() を参照してください。
この関数は Qt 6.7 で導入されました。
QFont::Tag 、setFeature()、unsetFeature()、isFeatureSet()、およびclearFeatures()も参照してください 。
[since 6.7] quint32 QFont::featureValue(QFont::Tag tag) const
特定の機能「tag 」に設定された値を返します。タグが設定されていない場合は、代わりに 0 が返されます。
フォント機能の詳細については、setFeature() を参照してください。
この関数は Qt 6.7 で導入されました。
QFont::Tag 、setFeature()、unsetFeature()、featureTags()、およびisFeatureSet()も参照してください 。
bool QFont::fixedPitch() const
固定ピッチが設定されている場合は `true ` を返し、そうでない場合は `false` を返します。
setFixedPitch() およびQFontInfo::fixedPitch()も参照してください 。
bool QFont::fromString(const QString &descrip)
このフォントを、descrip の記述に合わせて設定します。この記述は、toString() によって返されるフォント属性のカンマ区切りのリストです。
toString()も参照してください 。
QFont::HintingPreference QFont::hintingPreference() const
このフォントでレンダリングされるグリフに対して、現在優先されているヒンティングレベルを返します。
setHintingPreference()も参照してください 。
[static] void QFont::insertSubstitution(const QString &familyName, const QString &substituteName)
ファミリー「familyName 」の置換テーブルに「substituteName 」を挿入します。
フォントの置換後、すべての `QFont ` オブジェクトを破棄して再作成することで、フォントの更新をトリガーします。
insertSubstitutions()、removeSubstitutions()、substitutions()、substitute()、およびsubstitutes()も参照してください 。
[static] void QFont::insertSubstitutions(const QString &familyName, const QStringList &substituteNames)
substituteNames のファミリー一覧を、familyName の置換リストに挿入します。
フォントの置換後、すべての `QFont ` オブジェクトを破棄して再作成することで、フォントの更新をトリガーします。
insertSubstitution()、removeSubstitutions()、substitutions()、およびsubstitute()も参照してください 。
bool QFont::isCopyOf(const QFont &f) const
このフォントと `f ` が互いにコピー関係にある場合、つまり、一方が他方のコピーとして作成され、それ以降どちらも変更されていない場合に、true を返します。これは、等価性よりもはるかに厳格な条件です。
operator=() およびoperator==()も参照してください 。
[since 6.7] bool QFont::isFeatureSet(QFont::Tag tag) const
tag で指定されたフィーチャの値がQFont に設定されている場合は true を返し、そうでない場合は false を返します。
フォント機能の詳細については、setFeature() を参照してください。
この関数は Qt 6.7 で導入されました。
QFont::Tag 、setFeature()、unsetFeature()、featureTags()、およびfeatureValue()も参照してください 。
[since 6.7] bool QFont::isVariableAxisSet(QFont::Tag tag) const
tag で指定された変数軸の値が、QFont に設定されている場合は true を返し、そうでない場合は false を返します。
フォント変数軸の詳細については、setVariableAxis() を参照してください。
この関数は Qt 6.7 で導入されました。
QFont::Tag 、setVariableAxis()、unsetVariableAxis()、variableAxisValue()、およびclearVariableAxes()も参照してください 。
bool QFont::italic() const
true フォントのstyle()がQFont::StyleNormal
setItalic() およびstyle()も参照してください 。
bool QFont::kerning() const
このフォントでテキストを描画する際にカーニングを使用すべきかどうかを判定し、true を返します。
setKerning()も参照してください 。
QString QFont::key() const
フォントのキー、つまりフォントを表す文字列を返します。通常、フォントのキャッシュや辞書のキーとして使用されます。
QMapも参照してください 。
qreal QFont::letterSpacing() const
そのフォントの文字間隔を返します。
setLetterSpacing()、letterSpacingType()、およびsetWordSpacing()も参照してください 。
QFont::SpacingType QFont::letterSpacingType() const
文字間隔に使用される間隔の種類を返します。
letterSpacing()、setLetterSpacing()、およびsetWordSpacing()も参照してください 。
bool QFont::overline() const
overline が設定されている場合は `true ` を返し、そうでない場合は `false` を返します。
setOverline()も参照してください 。
int QFont::pixelSize() const
setPixelSize() を使用してフォントのピクセルサイズが設定されている場合、そのサイズを返します。setPointSize() またはsetPointSizeF() を使用してサイズが設定されている場合は、-1 を返します。
setPixelSize()、pointSize()、QFontInfo::pointSize()、およびQFontInfo::pixelSize()も参照してください 。
int QFont::pointSize() const
フォントのポイントサイズを返します。フォントサイズがピクセル単位で指定されている場合は、-1 を返します。
setPointSize() およびpointSizeF()も参照してください 。
qreal QFont::pointSizeF() const
フォントのポイントサイズを返します。フォントサイズがピクセル単位で指定されている場合は、-1を返します。
関連項目: pointSize()、setPointSizeF()、pixelSize()、QFontInfo::pointSize()、およびQFontInfo::pixelSize()。
[static] void QFont::removeSubstitutions(const QString &familyName)
familyName に対するすべての置換を削除します。
insertSubstitutions()、insertSubstitution()、substitutions()、およびsubstitute()も参照してください 。
QFont QFont::resolve(const QFont &other) const
このフォントに対してまだ設定されていない、other からコピーされた属性を持つ新しいQFont を返します。
void QFont::setBold(bool enable)
enable がtrueの場合、フォントの太さをQFont::Bold に設定します。そうでない場合は、太さをQFont::Normal に設定します。
太さの制御をより細かく行うには、setWeight() を使用してください。
注: styleName() が設定されている場合 、この値は無視されるか、プラットフォームでサポートされている場合は、フォントが人為的に太字にされることがあります。
bold() およびsetWeight()も参照してください 。
void QFont::setCapitalization(QFont::Capitalization caps)
このフォントのテキストの大文字小文字の表記を「caps 」に設定します。
フォントの大文字化設定により、テキストは選択された大文字化モードで表示されます。
capitalization()も参照してください 。
void QFont::setFamilies(const QStringList &families)
フォントのファミリー名のリストを設定します。名称は大文字小文字を区別せず、フォントメーカー名を含めることもできます。families 内の最初のファミリーが、そのフォントのメインファミリーとして設定されます。
families 内の各ファミリー名のエントリには、オプションでフォントメーカー名を含めることもできます(例:「Helvetica [Cronyx]」)。 そのファミリーが複数のフォントメーカーから提供されており、かつフォントメーカーが指定されていない場合、任意のフォントメーカーが選択されます。そのファミリーが利用できない場合は、font matching アルゴリズムを使用してファミリーが設定されます。
family()、families()、setFamily()、setStyleHint()、およびQFontInfoも参照してください 。
void QFont::setFamily(const QString &family)
フォントのファミリー名を設定します。この名前は大文字小文字を区別せず、フォントメーカー名を含めることもできます。
family という名称には、オプションでフォントメーカー名を含めることもできます(例:「Helvetica [Cronyx]」)。family が複数のフォントメーカーから提供されており、かつフォントメーカーが指定されていない場合、任意のフォントメーカーが選択されます。そのファミリーが利用できない場合は、font matching アルゴリズムを使用してファミリーが設定されます。
family()、setStyleHint()、setFamilies()、families()、およびQFontInfoも参照してください 。
[since 6.7] void QFont::setFeature(QFont::Tag tag, quint32 value)
テキストのシェーピングを行う際、tag で指定された組版機能に整数値を適用します。これにより、フォントのシェーピング処理への高度なアクセスが可能となり、API では通常サポートされていないフォント機能をサポートするために使用できます。
この機能は `tag` によって指定され、通常はフォント機能マップ内の4文字の機能名からエンコードされます。
ほとんどの場合、タグとともに渡されるこの整数値のvalue はブール値を表します。値が0の場合は機能が無効であり、0以外の値の場合は有効であることを意味します。ただし、特定のフォント機能によっては、異なる解釈がなされる場合があります。例えば、salt 機能に適用される場合、この値は使用するスタイルの代替案を指定するインデックスとなります。
例えば、「frac 」フォント機能は、スラッシュで区切られた斜め配置の分数(例:1/2 )を、異なる表現に変換します。通常、これには分数全体を単一の文字幅に収める処理(例:½ )が含まれます。
フォントがfrac 機能をサポートしている場合、フォント機能マップでfeatures["frac"] = 1 を設定することで、シェイパー内でこの機能を有効にできます。
注:デフォルトでは 、Qt は他のフォントプロパティに基づいて特定のフォント機能を有効または無効にします。 特に、「kern 」機能は、QFont のkerning() プロパティに応じて有効または無効になります。さらに、letterSpacing() が適用された場合、すべての合字機能(liga 、clig 、dlig 、hlig )は無効になりますが、これは合字の使用が装飾的な目的のみである文字体系に限られます。合字が必要な文字体系では、これらの機能はデフォルトの状態のままとなります。 setFeature() および関連関数を使用して設定された値は、デフォルトの挙動を上書きします。例えば、機能「kern」が 1 に設定されている場合、カーニングプロパティが false に設定されているかどうかにかかわらず、カーニングは常に有効になります。 同様に、0に設定された場合は、常に無効になります。フォント機能をデフォルトの動作に戻すには、unsetFeature() を使用して設定を解除します。
この関数は Qt 6.7 で導入されました。
関連項目: QFont::Tag 、clearFeatures()、unsetFeature()、およびfeatureTags()。
void QFont::setFixedPitch(bool enable)
enable が true の場合は、固定ピッチをオンに設定し、そうでない場合はオフに設定します。
fixedPitch() およびQFontInfoも参照してください 。
void QFont::setHintingPreference(QFont::HintingPreference hintingPreference)
グリフのヒンティングレベルに関する設定を「hintingPreference 」に設定します。これは、基盤となるフォントレンダリングシステムに対して特定のレベルのヒンティングを使用するよう指示するものであり、プラットフォームによってサポート状況が異なります。詳細については、QFont::HintingPreference のドキュメントにある表を参照してください。
デフォルトのヒンティング設定は `QFont::PreferDefaultHinting` です。
hintingPreference()も参照してください 。
void QFont::setItalic(bool enable)
enable がtrueの場合、フォントのstyle()をQFont::StyleItalic に設定します。そうでない場合は、スタイルはQFont::StyleNormal に設定されます。
注: styleName()が設定されている場合 、この値は無視されるか、プラットフォームでサポートされている場合は、デザインされたイタリックのフォントバリアントが選択される代わりに、フォントが傾いてレンダリングされることがあります。
italic() およびQFontInfoも参照してください 。
void QFont::setKerning(bool enable)
enable がtrueの場合、このフォントのカーニングを有効にします。そうでない場合は無効にします。デフォルトでは、カーニングは有効になっています。
カーニングが有効になっている場合、ラテン文字であってもグリフのメトリクスの合計値はもはや一致しなくなります。つまり、width('a') + width('b') が width("ab") に等しいという仮定は、必ずしも成り立たないということです。
kerning() およびQFontMetricsも参照してください 。
void QFont::setLetterSpacing(QFont::SpacingType type, qreal spacing)
フォントの文字間隔を「spacing 」に、間隔の種類を「type 」に設定します。
文字間隔を設定すると、フォント内の個々の文字間のデフォルトの間隔が変更されます。文字間隔は、選択した間隔の種類に応じて、文字幅に対するパーセンテージまたはピクセル単位で、狭くすることも広くすることもできます。
関連項目: letterSpacing()、letterSpacingType()、setWordSpacing()も参照してください 。
void QFont::setOverline(bool enable)
enable が true の場合は、上線をオンに設定し、そうでない場合はオフに設定します。
overline() およびQFontInfoも参照してください 。
void QFont::setPixelSize(int pixelSize)
フォントサイズをpixelSize ピクセルに設定します。最大サイズは符号なし16ビット整数です。
この関数を使用すると、フォントはデバイス依存になります。デバイス非依存の方法でフォントサイズを設定するには、setPointSize() またはsetPointSizeF() を使用してください。
pixelSize()も参照してください 。
void QFont::setPointSize(int pointSize)
ポイントサイズをpointSize に設定します。ポイントサイズは0より大きくなければなりません。
pointSize() およびsetPointSizeF()も参照してください 。
void QFont::setPointSizeF(qreal pointSize)
ポイントサイズをpointSize に設定します。ポイントサイズは0より大きくなければなりません。指定された精度は、すべてのプラットフォームで達成されるとは限りません。
pointSizeF()、setPointSize()、およびsetPixelSize()も参照してください 。
void QFont::setStretch(int factor)
フォントのストレッチ係数を設定します。
ストレッチ係数は、フォントのコンデンス版やエキスパンデッド版に合わせるほか、フォント内のすべての文字の幅をfactor パーセント変更するストレッチ変換を適用します。 たとえば、factor を150に設定すると、フォント内のすべての文字の幅が1.5倍(つまり150%)になります。ストレッチ係数の最小値は1、最大値は4000です。デフォルトのストレッチ係数はAnyStretch であり、この値では任意のストレッチ係数が受け入れられますが、フォントには変換が適用されません。
ストレッチ係数はアウトラインフォントにのみ適用されます。ビットマップフォントの場合、ストレッチ係数は無視されます。
注: デフォルト以外のネイティブストレッチ係数を持つフォントをマッチングさせる場合 、ストレッチ係数100を指定すると、フォントは中幅フォントの状態に戻ります。
関連項目: stretch() およびQFont::Stretch 。
void QFont::setStrikeOut(bool enable)
enable が true の場合は、strikeout を有効にします。そうでない場合は、strikeout を無効にします。
strikeOut() およびQFontInfoも参照してください 。
void QFont::setStyle(QFont::Style style)
フォントのスタイルを「style 」に設定します。
style()、italic()、およびQFontInfoも参照してください 。
void QFont::setStyleHint(QFont::StyleHint hint, QFont::StyleStrategy strategy = PreferDefault)
スタイルヒントとスタイル戦略を、それぞれhint およびstrategy に設定します。
これらが明示的に設定されていない場合、スタイルヒントはデフォルトでAnyStyle に、スタイル戦略はPreferDefault に設定されます。
Qt は、ウィンドウシステムからこの情報が提供されないため、X11 でのスタイルヒントをサポートしていません。
StyleHint 、styleHint()、StyleStrategy 、styleStrategy()、およびQFontInfoも参照してください 。
void QFont::setStyleName(const QString &styleName)
フォントのスタイル名を `styleName` に設定します。これを設定すると、フォントのマッチングにおいて `style()` や `weight()` などの他のスタイルプロパティは無視されますが、プラットフォームのフォントエンジンが対応している場合は、後でシミュレートされる可能性があります。
人工的にシミュレートされたスタイルの品質は低く、また完全なクロスプラットフォーム対応が確保されていないため、スタイル名によるマッチングとスタイルプロパティによるマッチングを併用することは推奨されません。
styleName()も参照してください 。
void QFont::setStyleStrategy(QFont::StyleStrategy s)
フォントのスタイル戦略を「s 」に設定します。
styleStrategy() およびQFont::StyleStrategyも参照してください 。
void QFont::setUnderline(bool enable)
enable が true の場合は下線をオンに設定し、そうでない場合は下線をオフに設定します。
underline() およびQFontInfoも参照してください 。
[since 6.7] void QFont::setVariableAxis(QFont::Tag tag, float value)
tag に対応する可変軸に、value を適用します。
可変フォントは、同じフォントファイル内に複数のバリエーション(太さ、幅、スタイルが異なるもの)を保存する方法を提供します。これらのバリエーションは、「可変軸」と呼ばれる事前定義されたパラメータセットに対する浮動小数点値として指定されます。 特定のインスタンスには通常、フォントデザイナーによって名前が付けられており、Qt では、従来のサブファミリーと同様に `setStyleName()` を使用してこれらを選択できます。
場合によっては、さまざまな軸に対して任意の値を指定できると便利なこともあります。たとえば、フォントに「Regular」と「Bold」のサブファミリーがある場合、その中間の太さを指定したいことがあるでしょう。その場合は、フォントの「wght」軸にカスタム値を指定することで、手動でこれを要求することができます。
フォントが「wght」軸をサポートしており、指定された値が定義された範囲内にある場合、ウェイト 550.0 に対応するフォントが提供されます。
多くのフォントが提供する標準的な軸として、「wght」(ウェイト)、「wdth」(幅)、「ital」(イタリック)、「opsz」(オプティカルサイズ)などがあります。これらにはそれぞれ、フォント自体で定義された個別の範囲があります。 たとえば、「wght」の範囲は 100 から 900(QFont::Thin からQFont::Black )であるのに対し、「ital」の範囲は 0 から 1(イタリックなしから完全なイタリック)である場合があります。
フォントでは、カスタム軸を定義することも可能です。唯一の制限は、その名前がQFont::Tag (4 文字の Latin-1 文字のシーケンス)の要件を満たしている必要があるという点です。
デフォルトでは、可変軸は設定されていません。
注: Windowsでは 、オプションの GDI フォントバックエンドを使用している場合、可変軸はサポートされません。
この関数は Qt 6.7 で導入されました。
unsetVariableAxisも参照してください 。
void QFont::setWeight(QFont::Weight weight)
QFont::Weight 列挙型で定義されたスケールを使用して、フォントのウェイトをweight に設定します。
注: styleName() が設定されている場合 、フォント選択においてこの値は無視されることがあります。
weight() およびQFontInfoも参照してください 。
void QFont::setWordSpacing(qreal spacing)
フォントの単語間隔をspacing に設定します。
単語間隔は、個々の単語間のデフォルトの間隔を変更します。正の値を指定すると、単語間隔が対応するピクセル数だけ広くなり、負の値を指定すると、それに応じて単語間隔が狭くなります。
単語間隔は、個々の単語が空白で区切られていない文字体系には適用されません。
wordSpacing() およびsetLetterSpacing()も参照してください 。
int QFont::stretch() const
そのフォントのストレッチ係数を返します。
setStretch()も参照してください 。
bool QFont::strikeOut() const
strikeout が設定されている場合は `true ` を返し、そうでない場合は `false` を返します。
setStrikeOut()も参照してください 。
QFont::Style QFont::style() const
フォントのスタイルを返します。
setStyle()も参照してください 。
QFont::StyleHint QFont::styleHint() const
StyleHint を返します。
スタイルヒントはfont matching algorithm に影響します。利用可能なヒントの一覧については、QFont::StyleHint を参照してください。
setStyleHint()、QFont::StyleStrategy 、およびQFontInfo::styleHint()も参照してください 。
QString QFont::styleName() const
指定されたフォントスタイル名を返します。これは、(他のスタイルプロパティでは正規化できない)不規則なスタイルのフォントを特定するために使用できます。
関連項目: setStyleName()、setFamily()、およびsetStyle()。
QFont::StyleStrategy QFont::styleStrategy() const
StyleStrategy を返します。
スタイル戦略は、font matching アルゴリズムに影響を与えます。利用可能な戦略の一覧については、QFont::StyleStrategy を参照してください。
setStyleStrategy()、setStyleHint()、およびQFont::StyleHintも参照してください 。
[static] QString QFont::substitute(const QString &familyName)
familyName が指定された際に使用される最初の姓を返します。この検索では大文字と小文字は区別されません。
familyName に対する置換がない場合、familyName が返されます。
置換のリストを取得するには、substitutes() を使用します。
関連項目: setFamily()、insertSubstitutions()、insertSubstitution()、およびremoveSubstitutions()。
[static] QStringList QFont::substitutes(const QString &familyName)
familyName が指定された際に使用される姓のリストを返します。検索では大文字と小文字を区別しません。
familyName に対する置換がない場合は、空のリストが返されます。
substitute()、insertSubstitutions()、insertSubstitution()、およびremoveSubstitutions()も参照してください 。
[static] QStringList QFont::substitutions()
置換された姓のソート済みリストを返します。
insertSubstitution()、removeSubstitutions()、およびsubstitute()も参照してください 。
[noexcept] void QFont::swap(QFont &other)
このフォントインスタンスをother と入れ替えます。この操作は非常に高速で、失敗することはありません。
QString QFont::toString() const
フォントの説明を返します。この説明は、属性のカンマ区切りリストであり、QSettings での使用に最適で、以下の内容で構成されています:
- フォントファミリー
- ポイントサイズ
- ピクセルサイズ
- スタイルヒント
- フォントの太さ
- フォントスタイル
- 下線
- 取り消し線
- 等幅
- 常に0
- 大文字化
- 文字間隔
- 単語間隔
- 伸縮
- スタイル戦略
- フォントスタイル
- フォントの機能
- 可変軸
関連項目: fromString()。
bool QFont::underline() const
underline が設定されている場合は `true ` を返し、そうでない場合は `false` を返します。
setUnderline()も参照してください 。
[since 6.7] void QFont::unsetFeature(QFont::Tag tag)
明示的に有効化または無効化された機能のマップから、tag の設定を解除します。
注: その機能が以前に追加されていなくても 、この操作により、このQFont におけるフォント機能マップが変更済みとしてマークされるため、他のフォントとの照合時に優先されます。
QFont 上の既存の機能を無効にすると、動作はデフォルトに戻ります。
フォント機能の詳細については、setFeature() を参照してください。
この関数は Qt 6.7 で導入されました。
QFont::Tag 、clearFeatures()、setFeature()、featureTags()、およびfeatureValue()も参照してください 。
[since 6.7] void QFont::unsetVariableAxis(QFont::Tag tag)
tag で指定された、以前に設定された変数軸の値を解除します。
この関数は Qt 6.7 で導入されました。
setVariableAxisも参照してください 。
[since 6.7] QList<QFont::Tag> QFont::variableAxisTags() const
このQFont に現在設定されているすべての可変軸のタグのリストを返します。
可変軸の詳細については、setVariableAxis() を参照してください。
この関数は Qt 6.7 で導入されました。
QFont::Tag 、setVariableAxis()、unsetVariableAxis()、isVariableAxisSet()、およびclearVariableAxes()も参照してください 。
[since 6.7] float QFont::variableAxisValue(QFont::Tag tag) const
特定の変数軸tag に設定された値を返します。タグが設定されていない場合は、代わりに0.0が返されます。
可変軸の詳細については、setVariableAxis() を参照してください。
この関数は Qt 6.7 で導入されました。
QFont::Tag 、setVariableAxis()、unsetVariableAxis()、isVariableAxisSet()、およびclearVariableAxes()も参照してください 。
QFont::Weight QFont::weight() const
QFont::Weight 列挙型と同じスケールを使用して、フォントのウェイトを返します。
関連項目: setWeight()、Weight 、およびQFontInfo 。
qreal QFont::wordSpacing() const
そのフォントの単語間隔を返します。
setWordSpacing() およびsetLetterSpacing()も参照してください 。
QFont::operator QVariant() const
そのフォントをQVariant
bool QFont::operator!=(const QFont &f) const
このフォントが `f` と異なる場合は `true ` を返し、そうでない場合は `false` を返します。
2つのQFontは、そのフォント属性が異なる場合、異なるものとみなされます。
operator==()も参照してください 。
bool QFont::operator<(const QFont &f) const
このフォントとフォントf を任意に比較します。保証されるのは、両方のフォントが等しい場合に演算子がfalse を返し、等しくない場合に (f1 < f2) == !(f2 < f1) を返すことだけです。
この関数は、例えばQFont オブジェクトをQMap のキーとして使用したい場合など、特定の状況で役立ちます。
operator==()、operator!=()、およびisCopyOf()も参照してください 。
[noexcept] QFont &QFont::operator=(QFont &&other)
other をこのQFont インスタンスに割り当てます。
QFont &QFont::operator=(const QFont &font)
このフォントにfont を割り当て、その参照を返します。
bool QFont::operator==(const QFont &f) const
このフォントが `f` と等しい場合は `true ` を返し、そうでない場合は `false` を返します。
2つのQFontは、そのフォント属性が等しい場合に等しいとみなされます。
operator!=() およびisCopyOf()も参照してください 。
関連する非メンバー関数
[noexcept] size_t qHash(const QFont &key, size_t seed = 0)
`key` のハッシュ値を返します。計算のシードには `seed ` を使用します。
QDataStream &operator<<(QDataStream &s, const QFont &font)
フォント `font ` をデータストリーム `s` に書き込みます。(`toString()` はテキストストリームに書き込みを行います。)
「QDataStream 演算子の形式」も参照してください 。
QDataStream &operator>>(QDataStream &s, QFont &font)
データストリーム `s` からフォント `font ` を読み込みます。(`fromString()` はテキストストリームから読み込みを行います。)
QDataStream 演算子の形式も参照してください 。
© 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.