FontDialog QML Type

Ein Schriftart-Dialog. Mehr...

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

Eigenschaften

options : flags
selectedFont : font

Ausführliche Beschreibung

Der FontDialog-Typ bietet eine QML-API für 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 selectedFont 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.selectedFont
}

Verfügbarkeit

Ein plattformeigener Schriftdialog ist derzeit auf den folgenden Plattformen verfügbar:

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

Qt Quick Dialogs verwendet eine Qt Quick -Implementierung als Fallback auf Plattformen, für die keine native Implementierung verfügbar ist.

Eigenschaft Dokumentation

options : flags

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

Standardmäßig sind alle Optionen deaktiviert.

Die Optionen sollten vor dem Anzeigen des Dialogs eingestellt werden. Wenn sie gesetzt werden, während der Dialog sichtbar ist, ist nicht garantiert, dass sie eine unmittelbare Auswirkung auf den Dialog haben (abhängig von der Option und 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 Open und Cancel nicht anzeigen (nützlich für "Live-Dialoge").
`FontDialog.DontUseNativeDialog`	Erzwingt, dass der Dialog eine nicht-native Quick-Implementierung verwendet.

selectedFont : font

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

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

Das Signal accepted() kann verarbeitet werden, um die endgültige Auswahl zu erhalten. Wenn der Benutzer auf Open geklickt hat, um eine Schriftart zu akzeptieren, kann ein Signalhandler für das Signal accepted() die Eigenschaft selectedFont abfragen, um die endgültige Schriftart zu erhalten, die vom Benutzer ausgewählt wurde.

Siehe auch currentFont und accepted().

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