ColorDialog QML Type

Ein Farbdialog. Mehr...

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

• options : flags
• selectedColor : color

Ausführliche Beschreibung

Der Typ „ColorDialog“ stellt eine QML-API für Farbdialoge bereit.

Um einen Farbdialog anzuzeigen, erstellen Sie eine Instanz von „ColorDialog“, legen Sie die gewünschten Eigenschaften fest und rufen Sie „ open()“ auf. Mit der Eigenschaft „ selectedColor “ lässt sich die anfänglich im Dialog ausgewählte Farbe festlegen.

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

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

MyDocument {
    id: document
}

Verfügbarkeit

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

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

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

Dokumentation zu den Eigenschaften

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 sie sich sofort auf das Dialogfeld auswirken (abhängig von der Option und der Plattform).

Verfügbare Optionen:

selectedColor : color

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

Das Signal „ accepted()“ kann abgefangen werden, um die endgültige Auswahl abzurufen. Wenn der Benutzer auf „ Open “ geklickt hat, um eine Farbe zu übernehmen, kann ein Signal-Handler 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()“.