QFontComboBox Class

QFontComboBox ウィジェットは、ユーザーがフォントファミリーを選択できるコンボボックスです。詳細...

ヘッダー #include <QFontComboBox>
CMake: find_package(Qt6 REQUIRED COMPONENTS Widgets)
target_link_libraries(mytarget PRIVATE Qt6::Widgets)
qmake: QT += widgets
継承: QComboBox

パブリックな型

enum FontFilter { AllFonts, ScalableFonts, NonScalableFonts, MonospacedFonts, ProportionalFonts }
flags FontFilters

プロパティ

パブリック関数

QFontComboBox(QWidget *parent = nullptr)
virtual ~QFontComboBox()
QFont currentFont() const
(since 6.3) std::optional<QFont> displayFont(const QString &fontFamily) const
QFontComboBox::FontFilters fontFilters() const
(since 6.3) QString sampleTextForFont(const QString &fontFamily) const
(since 6.3) QString sampleTextForSystem(QFontDatabase::WritingSystem writingSystem) const
(since 6.3) void setDisplayFont(const QString &fontFamily, const QFont &font)
void setFontFilters(QFontComboBox::FontFilters filters)
(since 6.3) void setSampleTextForFont(const QString &fontFamily, const QString &sampleText)
(since 6.3) void setSampleTextForSystem(QFontDatabase::WritingSystem writingSystem, const QString &sampleText)
void setWritingSystem(QFontDatabase::WritingSystem)
QFontDatabase::WritingSystem writingSystem() const

再実装パブリック関数

virtual QSize sizeHint() const override

パブリック・スロット

void setCurrentFont(const QFont &f)

シグナル

void currentFontChanged(const QFont &font)

再実装された保護された関数

virtual bool event(QEvent *e) override

詳しい説明

コンボボックスには、Arial、Helvetica、Times New Romanのようなフォントのファミリー名がアルファベット順に表示されます。ファミリー名は可能な限り実際のフォントを使って表示されます。Symbol のように、フォント自体で名前を表すことができないフォントについては、ファミリー名の横にフォントのサンプルが表示されます。

QFontComboBox は、フォントサイズを制御するためのQComboBox や、ボールドとイタリックのための 2 つのQToolButtonと共に、ツールバーでよく使用されます。

ユーザーが新しいフォントを選択すると、currentIndexChanged() に加えてcurrentFontChanged() シグナルが発せられます。

QFontComboBox に、 指定 し た書記体系に対応 し てい る フ ォ ン ト のみを表示す る よ う 指示す る にはsetWritingSystem ()、 特定の種類の フ ォ ン ト (た と えば非スケーラブルフ ォ ン ト や等幅フ ォ ン ト ) を除外す る にはsetFontFilters () を呼び出 し ます。

Screenshot of QFontComboBox on Windows Vista

QComboBoxQFontQFontInfoQFontMetricsQFontDatabaseも参照

メンバ型ドキュメント

enum QFontComboBox::FontFilter
flags QFontComboBox::FontFilters

この enum を使用すると、特定の種類のフォントだけをフォントコンボボックスに表示することができます。

定数説明
QFontComboBox::AllFonts0すべてのフォントを表示
QFontComboBox::ScalableFonts0x1スケーラブルフォントを表示
QFontComboBox::NonScalableFonts0x2スケーラブルでないフォントを表示する
QFontComboBox::MonospacedFonts0x4等幅フォントを表示する
QFontComboBox::ProportionalFonts0x8プロポーショナル・フォントを表示

FontFilters型はQFlags<FontFilter>のtypedefである。FontFilter値のORの組み合わせを格納する。

プロパティの説明

currentFont : QFont

このプロパティは、現在選択されているフォントを保持する。

アクセス関数

QFont currentFont() const
void setCurrentFont(const QFont &f)

ノーティファイアシグナル:

void currentFontChanged(const QFont &font)

currentIndex およびcurrentTextも参照

fontFilters : FontFilters

このプロパティはコンボボックスのフィルタを保持します。

デフォルトでは、すべてのフォントがリストされます。

アクセス関数:

QFontComboBox::FontFilters fontFilters() const
void setFontFilters(QFontComboBox::FontFilters filters)

writingSystemも参照してください

writingSystem : QFontDatabase::WritingSystem

このプロパティは、コンボボックスのフィルタとして機能するライティングシステムを保持します。

scriptQFontDatabase::Any (デフォルト)の場合、すべてのフォントがリストされます。

アクセス関数:

QFontDatabase::WritingSystem writingSystem() const
void setWritingSystem(QFontDatabase::WritingSystem)

fontFiltersも参照

メンバ関数文書

[explicit] QFontComboBox::QFontComboBox(QWidget *parent = nullptr)

与えられたparent でフォントコンボボックスを構築します。

[virtual noexcept] QFontComboBox::~QFontComboBox()

コンボボックスを破壊する。

[signal] void QFontComboBox::currentFontChanged(const QFont &font)

このシグナルは、現在のフォントが新しいfont で変更されるたびに発行されます。

注意: currentFont プロパティに対するノーティファイアシグナルです。

currentFontも参照してください

[since 6.3] std::optional<QFont> QFontComboBox::displayFont(const QString &fontFamily) const

与えられたfontFamily を表示するために使用されるフォント(設定されている場合)を返します(コンボが開いている場合)。

この関数は Qt 6.3 で導入されました。

setDisplayFont()も参照してください

[override virtual protected] bool QFontComboBox::event(QEvent *e)

再実装:QComboBox::event(QEvent *event)。

[since 6.3] QString QFontComboBox::sampleTextForFont(const QString &fontFamily) const

与えられたfontFamily に対して、フォント名の後に表示するサンプルテキストを(コンボが開いているときに)返します。

この関数は Qt 6.3 で導入されました。

setSampleTextForFont()も参照してください

[since 6.3] QString QFontComboBox::sampleTextForSystem(QFontDatabase::WritingSystem writingSystem) const

与えられたwritingSystem に対して、フォント名の後に表示するサンプルテキストを(コンボが開いているときに)返します。

この関数は Qt 6.3 で導入されました。

setSampleTextForSystem()も参照してください

[since 6.3] void QFontComboBox::setDisplayFont(const QString &fontFamily, const QFont &font)

与えられたfontFamily を表示するために使われるfont を設定します(コンボが開いているとき)。

この関数は Qt 6.3 で導入されました。

displayFont()も参照してください

[since 6.3] void QFontComboBox::setSampleTextForFont(const QString &fontFamily, const QString &sampleText)

与えられたfontFamily に対して、フォント名の後に表示するsampleText を設定します(コンボが開いているとき)。

この関数で指定されたサンプルテキストは、setSampleTextForSystem() で設定されたものよりも優先されます。

この関数は Qt 6.3 で導入されました。

sampleTextForFont()も参照してください

[since 6.3] void QFontComboBox::setSampleTextForSystem(QFontDatabase::WritingSystem writingSystem, const QString &sampleText)

指定 さ れたwritingSystem に対 し て、 フ ォ ン ト 名の後に表示す る ( コ ン ボが開いてい る と き に)sampleText を設定 し ます。

setSampleTextForFont() で与えられたサンプルテキストが優先されます。

この関数は Qt 6.3 で導入されました。

sampleTextForSystem()も参照してください

[override virtual] QSize QFontComboBox::sizeHint() const

再実装:QComboBox::sizeHint() const.

© 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.