このページでは

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()シグナルが発信されます。

setWritingSystem() を呼び出すと、QFontComboBox に、指定された文字体系をサポートするフォントのみを表示するよう指示できます。また、setFontFilters() を呼び出すと、スケーラブルでないフォントや等幅フォントなど、特定の種類のフォントを除外することができます。

Windows Vista 上の QFontComboBox のスクリーンショット

関連項目: QComboBox 、QFont 、QFontInfo 、QFontMetrics 、およびQFontDatabase 。

メンバ型のドキュメント

enum QFontComboBox::FontFilter
flags QFontComboBox::FontFilters

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

定数値説明
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

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

デフォルトでは、すべてのフォントが一覧表示されます。

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.