QFontComboBox Class
QFontComboBox ウィジェットは、ユーザーがフォントファミリーを選択できるコンボボックスです。詳細...
Header: | #include <QFontComboBox> |
CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
qmake: | QT += widgets |
Inherits: | 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) |
Notifier シグナル:
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.
©2024 The Qt Company Ltd. 本文書に含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。