Auf dieser Seite

FontDialog QML Type

Ein Schriftartendialog. Mehr...

Import Statement: import QtQuick.Dialogs
Since: Qt 6.2
Inherits:

Dialog

Eigenschaften

Ausführliche Beschreibung

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

Der Benutzer kann über den Schriftartendialog verschiedene Schriftarten anzeigen und auswählen.

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 ` selectedFont ` 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.selectedFont
}

Verfügbarkeit

Ein plattformnativer Schriftartendialog ist derzeit auf den folgenden Plattformen verfügbar:

  • iOS
  • Linux (bei Verwendung des GTK+-Plattform-Themas)
  • macOS

Qt Quick Dialogs verwendet auf Plattformen, auf denen keine native Implementierung verfügbar ist, eine „ Qt Quick “-Implementierung als Ausweichlösung.

Dokumentation zu den Eigenschaften

options : flags

Diese Eigenschaft enthält die verschiedenen Optionen, die das Erscheinungsbild des Dialogfelds beeinflussen.

Standardmäßig sind keine Optionen festgelegt, d. h., es werden alle Schriftarten angezeigt, und der Dialog enthält die Standardschaltflächen „ Select “ und „ Cancel “.

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 „ Open “ und „ Cancel “ nicht anzeigen (nützlich für „Live-Dialoge“).
FontDialog.DontUseNativeDialogErzwingt die Verwendung einer nicht-nativen Schnellimplementierung durch den Dialog.

selectedFont : font

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

Die Eigenschaft „ selectedFont “ wird aktualisiert, während der Benutzer im Dialogfeld Schriftarten auswählt, noch bevor die endgültige Auswahl getroffen wurde.

Das Signal „ accepted()“ kann abgefangen werden, um die endgültige Auswahl zu ermitteln. Wenn der Benutzer auf „ Select “ (oder „ Open “, je nach Plattform) geklickt hat, um eine Schriftart zu übernehmen, kann ein Signal-Handler für das Signal „ accepted()“ die Eigenschaft „selectedFont“ abfragen, um die endgültige, vom Benutzer ausgewählte Schriftart zu ermitteln.

Siehe auch „ currentFont “ und „ accepted()“.

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