QFont Class
QFont クラスは、テキストの描画に使用するフォントのクエリを指定します。詳細...
Header: | #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() | |
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 &font, 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
style strategy は、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 が 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 がゼロまたは負の場合、フォントのポイントサイズはシステム依存のデフォルト値に設定されます。通常、これは 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)
familyName の置換リストにファミリsubstituteNames のリストを挿入。
フ ォ ン ト を置換 し た後は、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 で指定された変数 axis の値が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)
フ ォ ン ト のstyle () を、enable が true ならば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 に設定します。 ポイント・サイズは 0 より大きくなければなりません。
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 が true ならば取り消し線を on に設定し、 そ う でなければ取り消し線を off に設定します。
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 ならば下線を on に設定し、そうでなければ下線を off に設定します。
[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
取り消し線が設定されている場合は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 &font, size_t seed = 0)
font に対するハッシュ値を返します。指定された場合、seed がハッシュの初期化に使用されます。
QDataStream &operator<<(QDataStream &s, const QFont &font)
フォントfont をデータストリームs に書き込みます。 (toString() はテキストストリームに書き込みます。)
QDataStream 演算子の書式も 参照 し て く だ さ い。
QDataStream &operator>>(QDataStream &s, QFont &font)
データストリームからフォントfont を読み込みますs. (fromString() はテキストストリームから読み込みます)。
QDataStream 演算子の書式」も参照して ください。
本ドキュメントに含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。