FontDialog QML Type

Ein nativer Schriftart-Dialog. Mehr...

Import Statement:	`import Qt.labs.platform`
Inherits:	Dialog

Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

currentFont : font
font : font
options : flags

Detaillierte Beschreibung

Der FontDialog-Typ bietet eine QML-API für plattformeigene Schriftdialoge.

Um einen FontDialog anzuzeigen, konstruieren Sie eine Instanz von FontDialog, setzen die gewünschten Eigenschaften und rufen open() auf. Die Eigenschaft currentFont kann verwendet werden, um die aktuell ausgewählte Schriftart im Dialog zu bestimmen. Die Eigenschaft font wird erst dann aktualisiert, wenn die endgültige Auswahl durch Akzeptieren 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 plattformeigener Schriftdialog ist derzeit auf den folgenden Plattformen verfügbar:

iOS
Linux (wenn mit dem GTK+-Plattformthema ausgeführt)
macOS

Das Qt Labs Platform Modul verwendet Qt Widgets als Fallback auf Plattformen, für die keine native Implementierung verfügbar ist. Daher sollten Anwendungen, die Typen aus dem Qt Labs Platform Modul verwenden, zu QtWidgets linken und QApplication statt QGuiApplication verwenden.

Um gegen die QtWidgets-Bibliothek zu linken, fügen Sie das Folgende zu Ihrer qmake-Projektdatei hinzu:

QT += widgets

Erstellen 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 ist nicht garantiert, dass Typen in Qt.labs-Modulen in zukünftigen Versionen kompatibel bleiben.

Eigenschaft Documentation

currentFont : font

Diese Eigenschaft enthält die aktuell ausgewählte Schriftart im Dialog.

Im Gegensatz zur Eigenschaft font wird die Eigenschaft currentFont aktualisiert, während der Benutzer Schriftarten im Dialog auswählt, auch bevor die endgültige Auswahl getroffen wurde.

Siehe auch font.

font : font

Diese Eigenschaft enthält die endgültig akzeptierte Schriftart.

Im Gegensatz zur Eigenschaft currentFont wird die Eigenschaft font nicht aktualisiert, während der Benutzer Schriftarten im Dialogfeld 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 auch das Signal accepted() verarbeitet werden, um die endgültige Auswahl zu erhalten.

Siehe auch currentFont und accepted().

options : flags

Diese Eigenschaft enthält die verschiedenen Optionen, die das Aussehen des Dialogs beeinflussen.

Standardmäßig sind alle Optionen deaktiviert.

Die Optionen sollten eingestellt werden, bevor das Dialogfeld angezeigt wird. Wenn sie gesetzt werden, während das Dialogfeld sichtbar ist, ist nicht garantiert, dass sie eine unmittelbare Auswirkung auf das Dialogfeld haben (abhängig von der Option und von der Plattform).

Verfügbare Optionen:

Konstant	Beschreibung
`FontDialog.ScalableFonts`	Skalierbare Schriftarten anzeigen.
`FontDialog.NonScalableFonts`	Nicht skalierbare Schriftarten anzeigen.
`FontDialog.MonospacedFonts`	Monospaced-Schriften anzeigen.
`FontDialog.ProportionalFonts`	Proportionale Schriftarten anzeigen.
`FontDialog.NoButtons`	Die Schaltflächen OK und Cancel nicht anzeigen (nützlich für "Live-Dialoge").

© 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.