Auf dieser Seite

FontDialog QML Type

Ein Dialogfeld für native Schriftarten. Mehr...

Import Statement: import Qt.labs.platform
Inherits:

Dialog

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

Ausführliche Beschreibung

Verwenden Sie stattdessen „ QtQuick.Dialogs FontDialog “.

Der Typ „FontDialog“ stellt eine QML-API für native Plattform-Schriftartendialoge bereit.

Ein Dialogfeld für native Schriftarten

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 += 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 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:

KonstanteBeschreibung
FontDialog.ScalableFontsSkalierbare Schriftarten anzeigen.
FontDialog.NonScalableFontsNicht skalierbare Schriftarten anzeigen.
FontDialog.MonospacedFontsMonospaced-Schriftarten anzeigen.
FontDialog.ProportionalFontsProportionale Schriftarten anzeigen.
FontDialog.NoButtonsDie 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.