ColorDialog QML Type

Ein Farbdialog. Mehr...

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

• options : flags
• selectedColor : color

Detaillierte Beschreibung

Der Typ ColorDialog bietet eine QML-API für Farbdialoge.

Um einen Farbdialog anzuzeigen, konstruieren Sie eine Instanz von ColorDialog, setzen die gewünschten Eigenschaften und rufen open() auf. Die Eigenschaft selectedColor kann verwendet werden, um die anfänglich ausgewählte Farbe im Dialog zu bestimmen.

MenuItem {
    text: qsTr("Color")
    onTriggered: colorDialog.open()
}

ColorDialog {
    id: colorDialog
    selectedColor: document.color
    onAccepted: document.color = selectedColor
}

MyDocument {
    id: document
}

Verfügbarkeit

Ein plattformeigener Farbdialog 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.

Dokumentation der Eigenschaft

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:

selectedColor : color

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

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

Siehe auch accepted().