ColorDialog QML Type

Ein Farbdialog. Mehr...

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

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.

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
`ColorDialog.ShowAlphaChannel`	Zeigt einen Schieberegler und zusätzliche Eingabefelder für den Alpha-Wert an.
`ColorDialog.NoButtons`	Die Schaltflächen Open und Cancel nicht anzeigen (nützlich für "Live-Dialoge").
`ColorDialog.NoEyeDropperButton`	Die Schaltfläche Eye Dropper nicht anzeigen. Dieser Wert wurde in Qt 6.6 hinzugefügt.
`ColorDialog.DontUseNativeDialog`	Erzwingt, dass der Dialog eine nicht-native Quick-Implementierung verwendet.

selectedColor : color

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

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().

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