QFontComboBox Class
Das QFontComboBox-Widget ist eine Combobox, mit der der Benutzer eine Schriftfamilie auswählen kann. Mehr...
| Kopfzeile: | #include <QFontComboBox> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets)target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| Vererbt: | QComboBox |
Öffentliche Typen
| enum | FontFilter { AllFonts, ScalableFonts, NonScalableFonts, MonospacedFonts, ProportionalFonts } |
| flags | FontFilters |
Eigenschaften
- currentFont : QFont
- fontFilters : FontFilters
- writingSystem : QFontDatabase::WritingSystem
Öffentliche Funktionen
| 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 |
Reimplementierte öffentliche Funktionen
| virtual QSize | sizeHint() const override |
Öffentliche Slots
| void | setCurrentFont(const QFont &f) |
Signale
| void | currentFontChanged(const QFont &font) |
Reimplementierte geschützte Funktionen
| virtual bool | event(QEvent *e) override |
Detaillierte Beschreibung
Die Combobox wird mit einer alphabetisch geordneten Liste von Schriftfamiliennamen gefüllt, wie z.B. Arial, Helvetica und Times New Roman. Wenn möglich, werden die Familiennamen in der tatsächlichen Schriftart angezeigt. Bei Schriftarten wie Symbol, bei denen der Name nicht in der Schrift selbst dargestellt werden kann, wird neben dem Familiennamen ein Muster der Schriftart angezeigt.
QFontComboBox wird häufig in Symbolleisten verwendet, zusammen mit einem QComboBox zur Steuerung der Schriftgröße und zwei QToolButtonfür fett und kursiv.
Wenn der Benutzer eine neue Schriftart auswählt, wird das Signal currentFontChanged() zusätzlich zu currentIndexChanged() ausgegeben.
Rufen Sie setWritingSystem() auf, um der QFontComboBox mitzuteilen, dass sie nur Schriftarten anzeigen soll, die ein bestimmtes Schriftsystem unterstützen, und setFontFilters(), um bestimmte Arten von Schriftarten herauszufiltern, wie z.B. nicht skalierbare Schriftarten oder monospaced Schriftarten.
Siehe auch QComboBox, QFont, QFontInfo, QFontMetrics, und QFontDatabase.
Member Type Dokumentation
enum QFontComboBox::FontFilter
flags QFontComboBox::FontFilters
Diese Aufzählung kann verwendet werden, um nur bestimmte Schriftarten in der Font-Combobox anzuzeigen.
| Konstante | Wert | Beschreibung |
|---|---|---|
QFontComboBox::AllFonts | 0 | Alle Schriftarten anzeigen |
QFontComboBox::ScalableFonts | 0x1 | Skalierbare Schriftarten anzeigen |
QFontComboBox::NonScalableFonts | 0x2 | Nicht skalierbare Schriften anzeigen |
QFontComboBox::MonospacedFonts | 0x4 | Monospaced-Schriften anzeigen |
QFontComboBox::ProportionalFonts | 0x8 | Proportionale Schriftarten anzeigen |
Der Typ FontFilters ist ein Typedef für QFlags<FontFilter>. Er speichert eine ODER-Kombination von FontFilter-Werten.
Dokumentation der Eigenschaft
currentFont : QFont
Diese Eigenschaft enthält die aktuell ausgewählte Schriftart
Zugriffsfunktionen:
| QFont | currentFont() const |
| void | setCurrentFont(const QFont &f) |
Benachrichtigungssignal:
| void | currentFontChanged(const QFont &font) |
Siehe auch currentIndex und currentText.
fontFilters : FontFilters
Diese Eigenschaft enthält den Filter für die Combobox
Standardmäßig werden alle Schriftarten aufgelistet.
Zugriffsfunktionen:
| QFontComboBox::FontFilters | fontFilters() const |
| void | setFontFilters(QFontComboBox::FontFilters filters) |
Siehe auch writingSystem.
writingSystem : QFontDatabase::WritingSystem
Diese Eigenschaft enthält das Schriftsystem, das als Filter für die Combobox dient
Wenn script auf QFontDatabase::Any steht (Standardeinstellung), werden alle Schriftarten aufgelistet.
Zugriffsfunktionen:
| QFontDatabase::WritingSystem | writingSystem() const |
| void | setWritingSystem(QFontDatabase::WritingSystem) |
Siehe auch fontFilters.
Dokumentation der Mitgliedsfunktionen
[explicit] QFontComboBox::QFontComboBox(QWidget *parent = nullptr)
Konstruiert eine Schriftart-Combobox mit der angegebenen parent.
[virtual noexcept] QFontComboBox::~QFontComboBox()
Zerstört die Combobox.
[signal] void QFontComboBox::currentFontChanged(const QFont &font)
Dieses Signal wird immer dann ausgegeben, wenn sich die aktuelle Schriftart ändert, mit der neuen font.
Hinweis: Benachrichtigungssignal für die Eigenschaft currentFont.
Siehe auch currentFont.
[since 6.3] std::optional<QFont> QFontComboBox::displayFont(const QString &fontFamily) const
Liefert die Schriftart (falls gesetzt), die für die Anzeige einer gegebenen fontFamily verwendet wird (wenn die Combo geöffnet ist).
Diese Funktion wurde in Qt 6.3 eingeführt.
Siehe auch setDisplayFont().
[override virtual protected] bool QFontComboBox::event(QEvent *e)
Reimplements: QComboBox::event(QEvent *Event).
[since 6.3] QString QFontComboBox::sampleTextForFont(const QString &fontFamily) const
Gibt den Beispieltext zurück, der nach dem Schriftnamen (wenn die Combo geöffnet ist) für eine bestimmte fontFamily angezeigt wird.
Diese Funktion wurde in Qt 6.3 eingeführt.
Siehe auch setSampleTextForFont().
[since 6.3] QString QFontComboBox::sampleTextForSystem(QFontDatabase::WritingSystem writingSystem) const
Gibt den Beispieltext zurück, der nach dem Schriftnamen (wenn die Combo geöffnet ist) für eine bestimmte writingSystem angezeigt wird.
Diese Funktion wurde in Qt 6.3 eingeführt.
Siehe auch setSampleTextForSystem().
[since 6.3] void QFontComboBox::setDisplayFont(const QString &fontFamily, const QFont &font)
Legt die font fest, die für die Anzeige einer bestimmten fontFamily verwendet wird (wenn die Combo geöffnet ist).
Diese Funktion wurde in Qt 6.3 eingeführt.
Siehe auch displayFont().
[since 6.3] void QFontComboBox::setSampleTextForFont(const QString &fontFamily, const QString &sampleText)
Legt den sampleText fest, der nach dem Schriftnamen (wenn die Combo geöffnet ist) für eine bestimmte fontFamily angezeigt wird.
Der mit dieser Funktion angegebene Beispieltext hat Vorrang vor dem mit setSampleTextForSystem() eingestellten Text.
Diese Funktion wurde in Qt 6.3 eingeführt.
Siehe auch sampleTextForFont().
[since 6.3] void QFontComboBox::setSampleTextForSystem(QFontDatabase::WritingSystem writingSystem, const QString &sampleText)
Legt fest, dass sampleText nach dem Namen der Schriftart (wenn die Combo geöffnet ist) für eine bestimmte writingSystem angezeigt wird.
Der mit setSampleTextForFont() angegebene Beispieltext hat Vorrang.
Diese Funktion wurde in Qt 6.3 eingeführt.
Siehe auch sampleTextForSystem().
[override virtual] QSize QFontComboBox::sizeHint() const
Reimplements: 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.
