QFontComboBox Class
Das QFontComboBox-Widget ist eine Kombinationsliste, mit der der Benutzer eine Schriftfamilie auswählen kann. Mehr...
| Überschrift: | #include <QFontComboBox> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS Widgets) target_link_libraries(mytarget PRIVATE Qt6::Widgets) |
| qmake: | QT += widgets |
| Erbt von: | 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 |
Neu implementierte öffentliche Funktionen
| virtual QSize | sizeHint() const override |
Öffentliche Slots
| void | setCurrentFont(const QFont &f) |
Signale
| void | currentFontChanged(const QFont &font) |
Neu implementierte geschützte Funktionen
| virtual bool | event(QEvent *e) override |
Detaillierte Beschreibung
Die Combobox wird mit einer alphabetisch sortierten Liste von Schriftfamiliennamen wie Arial, Helvetica und Times New Roman gefüllt. Schriftfamiliennamen werden nach Möglichkeit mit der jeweiligen Schriftart angezeigt. Bei Schriftarten wie „Symbol“, deren Name nicht in der Schriftart selbst darstellbar ist, wird neben dem Namen der Schriftfamilie ein Beispiel der Schriftart angezeigt.
QFontComboBox wird häufig in Symbolleisten verwendet, in Verbindung mit einem „ QComboBox “ zur Steuerung der Schriftgröße und zwei „ QToolButton“ für Fett- und Kursivschrift.
Wenn der Benutzer eine neue Schriftart auswählt, wird zusätzlich zu „ currentIndexChanged()“ das Signal „ currentFontChanged()“ ausgelöst.
Rufen Sie ` setWritingSystem()` auf, um QFontComboBox anzuweisen, nur Schriftarten anzuzeigen, die ein bestimmtes Schriftsystem unterstützen, und ` setFontFilters()`, um bestimmte Schriftarten, wie z. B. nicht skalierbare oder monospaced Schriftarten, herauszufiltern.
Siehe auch QComboBox, QFont, QFontInfo, QFontMetrics und QFontDatabase.
Dokumentation zu Mitgliedstypen
enum QFontComboBox::FontFilter
flags QFontComboBox::FontFilters
Mit dieser Enumeration lassen sich bestimmte Schriftarten in der Schriftart-Auswahlliste anzeigen.
| Konstante | Wert | Beschreibung |
|---|---|---|
QFontComboBox::AllFonts | 0 | Alle Schriftarten anzeigen |
QFontComboBox::ScalableFonts | 0x1 | Skalierbare Schriftarten anzeigen |
QFontComboBox::NonScalableFonts | 0x2 | Nicht skalierbare Schriftarten anzeigen |
QFontComboBox::MonospacedFonts | 0x4 | Monospaced-Schriftarten anzeigen |
QFontComboBox::ProportionalFonts | 0x8 | Proportionale Schriftarten anzeigen |
Der Typ „FontFilters“ ist eine typedef-Definition für QFlags<FontFilter>. Er speichert eine ODER-Kombination von FontFilter-Werten.
Dokumentation zur 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 Kombinationsfeld
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 “ gesetzt ist (Standardeinstellung), werden alle Schriftarten aufgelistet.
Zugriffsfunktionen:
| QFontDatabase::WritingSystem | writingSystem() const |
| void | setWritingSystem(QFontDatabase::WritingSystem) |
Siehe auch „ fontFilters “.
Dokumentation zu den Member-Funktionen
[explicit] QFontComboBox::QFontComboBox(QWidget *parent = nullptr)
Erstellt eine Schriftart-Auswahlbox mit dem angegebenen „ parent “.
[virtual noexcept] QFontComboBox::~QFontComboBox()
Löscht die Combobox.
[signal] void QFontComboBox::currentFontChanged(const QFont &font)
Dieses Signal wird immer dann ausgelöst, wenn sich die aktuelle Schriftart ändert, wobei die neue Eigenschaft „ font “ gilt.
Hinweis: Notifier -Signal für die Eigenschaft ` currentFont`.
Siehe auch „ currentFont “.
[since 6.3] std::optional<QFont> QFontComboBox::displayFont(const QString &fontFamily) const
Gibt die Schriftart (sofern festgelegt) zurück, die zur Anzeige eines bestimmten „ fontFamily “ verwendet werden soll (wenn das Kombinationsfeld geöffnet ist).
Diese Funktion wurde in Qt 6.3 eingeführt.
Siehe auch ` setDisplayFont()`.
[override virtual protected] bool QFontComboBox::event(QEvent *e)
Umsetzt: QComboBox::event(QEvent *event).
[since 6.3] QString QFontComboBox::sampleTextForFont(const QString &fontFamily) const
Gibt den Beispieltext zurück, der nach dem Schriftartnamen (bei geöffneter Kombinationsliste) für eine bestimmte „ fontFamily “ angezeigt werden soll.
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 Schriftartnamen (bei geöffneter Kombinationsliste) für eine bestimmte „ writingSystem “ angezeigt werden soll.
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 zur Anzeige eines bestimmten „ fontFamily “ verwendet werden soll (wenn das Kombinationsfeld 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 fest, dass der „ sampleText “ nach dem Schriftartnamen angezeigt wird (wenn das Kombinationsfeld geöffnet ist), und zwar für eine bestimmte „ fontFamily “.
Der mit dieser Funktion angegebene Beispieltext hat Vorrang vor dem mit ` setSampleTextForSystem()` festgelegten.
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 der „ sampleText “ hinter dem Schriftartnamen angezeigt wird (wenn das Kombinationsfeld geöffnet ist), und zwar für eine bestimmte „ writingSystem “.
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
Implementiert: ` 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.
