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() シグナルが発せられます。
QFontComboBox に、 指定 し た書記体系に対応 し てい る フ ォ ン ト のみを表示す る よ う 指示す る にはsetWritingSystem ()、 特定の種類の フ ォ ン ト (た と えば非スケーラブルフ ォ ン ト や等幅フ ォ ン ト ) を除外す る にはsetFontFilters () を呼び出 し ます。
QComboBox 、QFont 、QFontInfo 、QFontMetrics 、QFontDatabaseも参照 。
メンバ型ドキュメント
enum QFontComboBox::FontFilter
flags QFontComboBox::FontFilters
この enum を使用すると、特定の種類のフォントだけをフォントコンボボックスに表示することができます。
定数 | 値 | 説明 |
---|---|---|
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
このプロパティはコンボボックスのフィルタを保持します。
デフォルトでは、すべてのフォントがリストされます。
アクセス関数:
QFontComboBox::FontFilters | fontFilters() const |
void | setFontFilters(QFontComboBox::FontFilters filters) |
writingSystemも参照してください 。
writingSystem : QFontDatabase::WritingSystem
このプロパティは、コンボボックスのフィルタとして機能するライティングシステムを保持します。
script がQFontDatabase::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.