FontDialog QML Type
Ein Dialogfeld für native Schriftarten. Mehr...
| Import Statement: | import Qt.labs.platform |
| Inherits: | |
| Status: | Deprecated since 6.9 |
Dieser Typ ist seit Qt Labs Platform 6.9 veraltet. Wir raten dringend davon ab, ihn in neuem Code zu verwenden.
Eigenschaften
- currentFont : font
- font : font
- options : flags
Ausführliche Beschreibung
Verwenden Sie stattdessen „ QtQuick.Dialogs FontDialog “.
Der Typ „FontDialog“ stellt eine QML-API für native Plattform-Schriftartendialoge bereit.

Um einen Schriftartendialog anzuzeigen, erstellen Sie eine Instanz von `FontDialog`, legen Sie die gewünschten Eigenschaften fest und rufen Sie ` open()` auf. Mit der Eigenschaft ` currentFont ` lässt sich die aktuell im Dialog ausgewählte Schriftart ermitteln. Die Eigenschaft ` font ` wird erst aktualisiert, nachdem die endgültige Auswahl durch Bestätigen des Dialogs getroffen wurde.
MenuItem {
text: "Font"
onTriggered: fontDialog.open()
}
FontDialog {
id: fontDialog
currentFont.family: document.font
}
MyDocument {
id: document
font: fontDialog.font
}Verfügbarkeit
Ein plattformnativer Schriftartendialog ist derzeit auf den folgenden Plattformen verfügbar:
- iOS
- Linux (bei Verwendung des GTK+-Plattformthemas)
- macOS
Das Modul „ Qt Labs Platform “ verwendet „ Qt Widgets “ als Fallback auf Plattformen, auf denen keine native Implementierung verfügbar ist. Daher sollten Anwendungen, die Schriftarten aus dem Modul „ Qt Labs Platform “ verwenden, einen Link zu „ QtWidgets “ herstellen und „ QApplication “ anstelle von „ QGuiApplication “ verwenden.
Um eine Verknüpfung mit der Bibliothek „ QtWidgets “ herzustellen, fügen Sie Folgendes in Ihre qmake-Projektdatei ein:
QT += widgetsErstellen Sie eine Instanz von „ QApplication “ in „ main() “:
#include <QApplication>
#include <QQmlApplicationEngine>
int main(int argc, char *argv[])
{
QApplication app(argc, argv);
QQmlApplicationEngine engine;
engine.load(QUrl(QStringLiteral("qrc:/main.qml")));
return app.exec();
}Hinweis: Es kann nicht garantiert werden, dass die Typen in Qt.labs-Modulen in zukünftigen Versionen kompatibel bleiben.
Siehe auch „ QtQuick.Dialogs::FontDialog “.
Dokumentation zu den Eigenschaften
currentFont : font
Diese Eigenschaft enthält die aktuell im Dialogfeld ausgewählte Schriftart.
Im Gegensatz zur Eigenschaft „ font “ wird die Eigenschaft „ currentFont “ aktualisiert, während der Benutzer im Dialogfeld Schriftarten auswählt, noch bevor die endgültige Auswahl getroffen wurde.
Siehe auch „ font “.
font : font
Diese Eigenschaft enthält die zuletzt ausgewählte Schriftart.
Im Gegensatz zur Eigenschaft „ currentFont “ wird die Eigenschaft „ font “ nicht aktualisiert, während der Benutzer im Dialogfeld Schriftarten auswählt, sondern erst, nachdem die endgültige Auswahl getroffen wurde. Das heißt, wenn der Benutzer auf „ OK “ geklickt hat, um eine Schriftart zu akzeptieren. Alternativ kann das Signal „ accepted()“ abgefragt werden, um die endgültige Auswahl zu erhalten.
Siehe auch „ currentFont “ und „ accepted()“.
options : flags
Diese Eigenschaft enthält die verschiedenen Optionen, die das Erscheinungsbild des Dialogfelds beeinflussen.
Standardmäßig sind alle Optionen deaktiviert.
Die Optionen sollten vor dem Anzeigen des Dialogfelds festgelegt werden. Wenn sie festgelegt werden, während das Dialogfeld bereits sichtbar ist, ist nicht garantiert, dass sich dies sofort auf das Dialogfeld auswirkt (abhängig von der Option und der Plattform).
Verfügbare Optionen:
| Konstante | Beschreibung |
|---|---|
FontDialog.ScalableFonts | Skalierbare Schriftarten anzeigen. |
FontDialog.NonScalableFonts | Nicht skalierbare Schriftarten anzeigen. |
FontDialog.MonospacedFonts | Monospaced-Schriftarten anzeigen. |
FontDialog.ProportionalFonts | Proportionale Schriftarten anzeigen. |
FontDialog.NoButtons | Die Schaltflächen „ OK “ und „ Cancel “ nicht anzeigen (nützlich für „Live-Dialoge“). |
© 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.