ColorDialog QML Type

Ein nativer Farbdialog. Mehr...

Dieser Typ ist seit Qt.labs.platform 6.9 veraltet. Wir raten dringend davon ab, ihn in neuem Code zu verwenden.

• Liste aller Mitglieder, einschließlich geerbter Mitglieder

Eigenschaften

• color : color
• currentColor : color
• options : flags

Ausführliche Beschreibung

Verwenden Sie stattdessen QtQuick.Dialogs ColorDialog.

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

Um einen Farbdialog anzuzeigen, konstruieren Sie eine Instanz von ColorDialog, setzen die gewünschten Eigenschaften und rufen open() auf. Die Eigenschaft currentColor kann verwendet werden, um die aktuell ausgewählte Farbe im Dialog zu bestimmen. Die Eigenschaft color wird erst dann aktualisiert, wenn die endgültige Auswahl durch Akzeptieren des Dialogs getroffen wurde.

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

ColorDialog {
    id: colorDialog
    currentColor: document.color
}

MyDocument {
    id: document
    color: colorDialog.color
}

Verfügbarkeit

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

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

Das Modul Qt Labs Platform verwendet Qt Widgets als Fallback auf Plattformen, für die keine native Implementierung verfügbar ist. Daher sollten Anwendungen, die Typen aus dem Modul Qt Labs Platform verwenden, mit QtWidgets verknüpft werden und QApplication anstelle von QGuiApplication verwenden.

Um gegen die QtWidgets Bibliothek zu linken, fügen Sie das Folgende zu Ihrer qmake Projektdatei hinzu:

QT += widgets

Erstellen Sie eine Instanz von QApplication in main():

#include <QApplication>
#include <QQmlApplicationEngine>

int main(int argc, char *argv[])
{
    QApplication app(argc, argv);
    QQmlApplicationEngine engine;
    engine.load(QUrl(QStringLiteral("qrc:/main.qml")));
    return app.exec();
}

Siehe auch QtQuick.Dialogs::ColorDialog.

Dokumentation der Eigenschaften

color : color

Diese Eigenschaft enthält die endgültig akzeptierte Farbe.

Anders als die Eigenschaft currentColor wird die Eigenschaft color nicht aktualisiert, während der Benutzer Farben im Dialogfeld auswählt, sondern erst, nachdem die endgültige Auswahl getroffen wurde. Das heißt, wenn der Benutzer auf OK geklickt hat, um eine Farbe zu akzeptieren. Alternativ kann auch das Signal accepted() verarbeitet werden, um die endgültige Auswahl zu erhalten.

Siehe auch currentColor und accepted().

currentColor : color

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

Im Gegensatz zur Eigenschaft color wird die Eigenschaft currentColor aktualisiert, während der Benutzer Farben im Dialogfeld auswählt, auch bevor die endgültige Auswahl getroffen wurde.

Siehe auch color.

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: