ColorDialog QML Type

Ein nativer Farbdialog. Mehr...

Import Statement: import Qt.labs.platform
Inherits:

Dialog

Eigenschaften

Detaillierte Beschreibung

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 Qt Labs Platform Modul verwendet Qt Widgets als Fallback auf Plattformen, für die keine native Implementierung verfügbar ist. Daher sollten Anwendungen, die Typen aus dem Qt Labs Platform Modul verwenden, zu QtWidgets linken und QApplication statt 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();
}

Hinweis: Es ist nicht garantiert, dass Typen in Qt.labs-Modulen in zukünftigen Versionen kompatibel bleiben.

Eigenschaft Dokumentation

color : color

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

Im Gegensatz zur Eigenschaft currentColor wird die Eigenschaft color nicht aktualisiert, während der Benutzer im Dialog 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 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 ausgewählte Farbe im Dialog.

Anders als die Eigenschaft color wird die Eigenschaft currentColor aktualisiert, während der Benutzer im Dialog Farben 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 der Plattform).

Verfügbare Optionen:

KonstantBeschreibung
ColorDialog.ShowAlphaChannelErlaubt dem Benutzer, die Alpha-Komponente einer Farbe auszuwählen.
ColorDialog.NoButtonsDie Schaltflächen OK und Cancel nicht anzeigen (nützlich für "Live-Dialoge").

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