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` stellt eine QML-API für native Plattform-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 ` currentColor ` lässt sich die aktuell im Dialog ausgewählte Farbe ermitteln. Die Eigenschaft ` color ` wird erst aktualisiert, nachdem die endgültige Auswahl durch Bestätigen 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 plattformnativer Farbdialog ist derzeit auf den folgenden Plattformen verfügbar:

• iOS
• Linux (bei Ausführung mit dem GTK+-Plattform-Theme)
• macOS

Das Modul „ Qt Labs Platform “ verwendet „ Qt Widgets “ als Fallback auf Plattformen, auf denen keine native Implementierung verfügbar ist. Daher sollten Anwendungen, die Typen aus dem Modul „ Qt Labs Platform “ verwenden, eine Verknüpfung zu „ QtWidgets “ herstellen und „ QApplication “ anstelle von „ QGuiApplication “ verwenden.

Um eine Verknüpfung mit der Bibliothek „ QtWidgets “ herzustellen, fügen Sie Folgendes in Ihre qmake-Projektdatei ein:

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 zu den Eigenschaften

color : color

Diese Eigenschaft enthält die zuletzt akzeptierte Farbe.

Im Gegensatz zur Eigenschaft „ currentColor “ wird die Eigenschaft „ color “ nicht aktualisiert, während der Benutzer im Dialogfeld Farben 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 bestätigen. Alternativ kann das Signal „ accepted()“ abgefangen werden, um die endgültige Auswahl zu erhalten.

Siehe auch „ currentColor “ und „ accepted()“.

currentColor : color

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

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

Siehe auch „ color “.

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

Verfügbare Optionen: