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

プロパティ

パブリック関数

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)

Notifier シグナル:

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.

©2024 The Qt Company Ltd. 本文書に含まれる文書の著作権は、それぞれの所有者に帰属します。 本書で提供されるドキュメントは、Free Software Foundation が発行したGNU Free Documentation License version 1.3に基づいてライセンスされています。 Qtおよびそれぞれのロゴは、フィンランドおよびその他の国におけるThe Qt Company Ltd.の 商標です。その他すべての商標は、それぞれの所有者に帰属します。