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 |
プロパティ
- currentFont : QFont
- fontFilters : FontFilters
- writingSystem : QFontDatabase::WritingSystem
パブリック関数
| 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()シグナルが発信されます。
setWritingSystem() を呼び出すと、QFontComboBox に、指定された文字体系をサポートするフォントのみを表示するよう指示できます。また、setFontFilters() を呼び出すと、スケーラブルでないフォントや等幅フォントなど、特定の種類のフォントを除外することができます。

関連項目: QComboBox 、QFont 、QFontInfo 、QFontMetrics 、およびQFontDatabase 。
メンバ型のドキュメント
enum QFontComboBox::FontFilter
flags QFontComboBox::FontFilters
この列挙型を使用すると、フォントコンボボックスに特定の種類のフォントのみを表示することができます。
| 定数 | 値 | 説明 |
|---|---|---|
QFontComboBox::AllFonts | 0 | すべてのフォントを表示する |
QFontComboBox::ScalableFonts | 0x1 | スケーラブルなフォントを表示 |
QFontComboBox::NonScalableFonts | 0x2 | スケーラブルでないフォントを表示 |
QFontComboBox::MonospacedFonts | 0x4 | 等幅フォントを表示 |
QFontComboBox::ProportionalFonts | 0x8 | プロポーショナルフォントを表示 |
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
このプロパティは、コンボボックスのフィルタを保持します
デフォルトでは、すべてのフォントが一覧表示されます。
Accessの関数:
| QFontComboBox::FontFilters | fontFilters() const |
| void | setFontFilters(QFontComboBox::FontFilters filters) |
writingSystemも参照してください 。
writingSystem : QFontDatabase::WritingSystem
このプロパティは、コンボボックスのフィルタとして機能する文字体系を指定します
script がQFontDatabase::Any (デフォルト)の場合、すべてのフォントが一覧表示されます。
Accessの関数:
| 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 を再実装します。
© 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.