QFont Class
QFont クラスは、テキストの描画に使用するフォントのクエリを指定します。詳細...
ヘッダー | #include <QFont> |
CMake: | find_package(Qt6 REQUIRED COMPONENTS Gui) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
qmake: | QT += gui |
- 継承メンバを含む全メンバのリスト
- 非推奨メンバー
- QFontは、Painting Classes、Implicitly Shared Classes、Rich Text Processing APIsの一部です。
注意:このクラスの関数はすべてリエントラントです。
パブリック型
(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() | |
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 |
QVariant | 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 は指定された属性を持つフォントを使用し、一致するフォントが存在しない場合は、インストールされているフォントの中で最も近いものを使用します。実際に使用されるフォントの属性は、QFontInfo オブジェクトから取得できます。ウ ィ ン ド ウ シ ス テ ムが完全一致を提供 し てい る 場合は、exactMatch() はtrue
を返 し ます。QFontMetrics::width() を使って文字列のピクセル長などの測定値を得るにはQFontMetricsF を使います。
特に設定されていない属性はフ ォ ン ト 選択アルゴ リ ズ ムに影響を与えず、 デフ ォ ル ト 値が優先 さ れます。
特定の物理フォント(通常は 1 つのファイルで表される)を読み込むには、代わりに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 オブジェクトから取得できます。
要求 さ れた フ ォ ン ト フ ァ ミ リ が得 ら れない と き は、QFont::StyleHint とQFont::StyleStrategy をsetStyleHint() で選択す る こ と に よ っ て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 style strategy を使って無効にすることができます。
Windows では、"Courier" フォントのリクエストは自動的に "Courier New" に変更されます。旧バージョンの「Courier」ビットマップフォントは、PreferBitmap スタイルストラテジーを設定することで選択できます(setStyleStrategy ()を参照)。
フ ォ ン ト が見つかれば、 残 り の属性が優先順位の高い順に照合 さ れます:
- fixedPitch()
- pointSize() (後述)
- weight()
- style()
familyで一致するフォントがある場合、他の属性がどれも一致しなくても、familyで一致しないが他の属性で一致するフォントよりも優先してこのフォントが選ばれます。これは、フォントファミリーが検索基準として支配的だからです。
ポイントサイズは、要求されたポイントサイズの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 が有効 | フルヒンティング | 垂直ヒンティング | 垂直ヒンティング | フルヒント |
フリータイプ | オペレーティングシステム設定 | ヒンティングなし | 垂直ヒンティング(ライト) | フルヒンティング |
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 generic font-family 'monospace' にマップされるフォントを優先します。 |
QFont::Fantasy | 8 | フォントマッチャーは CSS general font-family 'fantasy' に対応するフォントを優先します。 |
QFont::Cursive | 6 | フォントマッチャーは CSS generic font-family '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 フ ォ ン ト は、 縦線 メ ト リ ッ ク の 2 つの競合セ ッ ト を含んでお り 、 こ れ ら はフ ォ ン ト のascent ・descent ・leading を提供 し ます。こ れ ら は し ば し ばwin(Windows) メ ト リ ッ ク とtypo(組版) メ ト リ ッ ク と 呼ばれます。仕様では、行間にはtypo メ ト リ ッ ク を用いる こ と を推奨 し てい ますが、 多 く のアプ リ ケーシ ョ ンは、 フ ォ ン ト のfsSelectionフ ィ ール ド でUSE_TYPO_METRICS フ ラ グが設定 さ れていない限 り 、win メ ト リ ッ ク を好みます。後方互換性の理由から、これは Qt アプ リ ケーシ ョ ンの場合も同様です。こ れは、typo メ ト リ ッ ク が有効であ る こ と を示すUSE_TYPO_METRICS フ ラ グ を設定 し てい る フ ォ ン ト や、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)
ペ イ ン ト デバ イ スpd で使 う ための フ ォ ン ト をfont か ら構築 し ます。
QFont::QFont(const QString &family, int pointSize = -1, int weight = -1, bool italic = false)
指定されたfamily,pointSize,weight およびitalic 設定でフォントオブジェクトを構築する。
pointSize がゼロまたは負の場合、フォントのポイントサイズはシステム依存のデフォルト値に設定されます。通常、これは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 がゼロまたは負の場合、フォントのポイントサイズはシステム依存のデフォルト値に設定されます。通常、これは 12 ポイントです。
families の各ファミリー名エントリには、オプションでファウンドリ名も含めることができます。そのファミリーが複数のファウンドリから入手可能で、ファウンドリが指定されていない場合、任意のファウンドリが選択されます。ファミリが利用できない場合は、font matching アルゴリズムを使用してファミリが設定されます。
Weight 、setPointSize ()、setWeight ()、setItalic ()、setStyleHint ()、setFamilies ()、QGuiApplication::font ()も参照の こと。
QFont::QFont(const QFont &font)
font のコ ピーであ る フ ォ ン ト を構築 し ます。
[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
フォントのstyle() がtrue
でない場合、 を返す。QFont::StyleNormal
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
オーバーラインが設定されていれば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() が設定されている場合、この値は無視されるか、あるいはプラットフォームでサポートされている場合、フォントは人為的に太字になります。
void QFont::setCapitalization(QFont::Capitalization caps)
このフォントのテキストの大文字小文字をcaps に設定します。
フォントの大文字化は、選択された大文字化モードでテキストを表示します。
capitalization()も参照 。
void QFont::setFamilies(const QStringList &families)
フォントのファミリー名のリストを設定します。名前は大文字小文字を区別せず、ファウンドリ名を含めることもできます。families の最初のファミリがフォントのメインファミリとして設定されます。
families の各ファミリ名の項目には、オプションでファウンドリ名を含めることもできます。ファミリが複数のファウンドリから入手可能で、ファウンドリが指定されていない場合は、任意のファウンドリが選択されます。ファミリが利用できない場合は、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 は、 多 く の場合ブー リ アン値を表 し ます:ゼロ値はその機能が無効であ る こ と を意味 し 、 非ゼ ロ 値は有効であ る こ と を意味 し ます。しかし、特定のフォント機能については、別の解釈をすることがあります。例えば、salt
機能に適用される場合、値は、使用する文体の代替を指定するインデックスです。
た と えば、frac
フ ォ ン ト 機能は、 ス ラ ッ シ ュ で区切 ら れた対角線上の分数 (1/2
の よ う に) を別の表現で変換 し ます。通常 こ れは、 分数全体を 1 文字幅に焼 き 出す こ と にな り ます (½
の よ う に)。
フォントがfrac
機能に対応している場合は、フォント機能マップでfeatures["frac"] = 1
を設定することで、シェイパーで有効にすることができます。
注意: デフォルトでは、Qt は他のフォントプロパティに基づいて特定のフォント機能を有効にしたり無効にしたりします。特に、kern
機能は、QFont のkerning() プロパティに依存して有効 / 無効になります。 さらに、すべての合字機能 (liga
,clig
,dlig
,hlig
) は、letterSpacing() が適用されると無効になります。合字が必要な筆記システムでは、これらの機能はデフォルトの状態のままになります。setFeature() や関連する関数で設定された値は、デフォルトの動作を上書きします。たとえば、機能 "kern" を 1 に設定すると、カーニング・プロパティが false に設定されているかどうかにかかわらず、カーニングは常に有効になります。同様に、"kern" が 0 に設定されている場合は、常に無効になります。フォント機能をデフォルトの動作に戻すには、unsetFeature ()を使って設定を解除することができます。
この関数は Qt 6.7 で導入されました。
QFont::Tag,clearFeatures(), setFeature(),unsetFeature(),featureTags()も参照してください 。
void QFont::setFixedPitch(bool enable)
enable が真の場合、固定ピッチをオンに設定し、そうでない場合は固定ピッチをオフに設定する。
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() が設定されている場合、この値は無視されるかもしれませんし、プラットフォームでサポートされている場合、フォントは、設計されたイタリック体のフォント変数を選ぶ代わりに、傾いてレンダリングされるかもしれません。
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 が真の場合、上書きをオンに設定し、そうでない場合、上書きをオフに設定する。
overline() およびQFontInfoも参照のこと 。
void QFont::setPixelSize(int pixelSize)
フォントサイズをpixelSize ピクセルに設定する。最大サイズは符号なし 16 ビット整数。
この関数を使用すると、フォントのサイズがデバイスに依存するようになります。デバイスに依存しない方法でフォントサイズを設定するには、setPointSize() またはsetPointSizeF() を使用する。
pixelSize()も参照 。
void QFont::setPointSize(int pointSize)
ポイント・サイズをpointSize に設定する。 ポイント・サイズはゼロより大きくなければならない。
pointSize() およびsetPointSizeF()も参照 。
void QFont::setPointSizeF(qreal pointSize)
ポイントサイズをpointSize に設定する。 ポイントサイズはゼロより大きくなければならない。要求された精度は、すべてのプラットフォームで達成されるとは限らない。
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 が真の場合、取り消し線をオンに設定し、そうでない場合、取り消し線をオフに設定する。
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 が真の場合、下線をオンに設定し、そうでない場合、下線をオフに設定する。
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 個の ラ テ ィ ン 1 キ ャ ラ ク タ の並び) の要件を満たす必要があ る こ と です。
デフ ォル ト では、 可変軸は設定 さ れてい ません。
注意: Windows では、オプションの GDI フォントバックエンドが使用されている場合、可変軸はサポートされません。
この関数は Qt 6.7 で導入されました。
unsetVariableAxisも参照してください 。
void QFont::setWeight(QFont::Weight weight)
フ ォ ン ト の太 さ を、QFont::Weight 列挙で定義 さ れてい る 目盛 り を用いて、weight に設定 し ます。
注意: styleName() が設定されている場合、この値はフォント選択時に無視されることがあります。
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
下線が設定されている場合は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()も参照 。
QVariant QFont::operator QVariant() const
フォントをQVariant
bool QFont::operator!=(const QFont &f) const
このフォントがf と異なる場合はtrue
を返し、そうでない場合はfalse
を返します。
つの QFonts は、そのフォント属性が異なれば異なるとみなされます。
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)
Move-other をこのQFont インスタンスに割り当てる。
QFont &QFont::operator=(const QFont &font)
このフォントにfont を割り当て、その参照を返します。
bool QFont::operator==(const QFont &f) const
このフォントがf と等しければtrue
を返し、そうでなければ false を返します。
2 つの QFonts は、そのフォント属性が等しければ等しいとみなされます。
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 演算子のフォーマットも参照してください 。
© 2025 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.