ColorDialog QML Type

Dialog component for choosing a color. More...

• List of all members, including inherited members

Properties

• color : color
• currentColor : color
• modality : Qt::WindowModality
• showAlphaChannel : bool
• title : string
• visible : bool

Methods

• void close()
• void open()

Detailed Description

ColorDialog allows the user to select a color. The dialog is initially invisible. You need to set the properties as desired first, then set visible to true or call open().

Here is a minimal example to open a color dialog and exit after the user chooses a color:

 import QtQuick 2.2
 import QtQuick.Dialogs 1.0

 ColorDialog {
     id: colorDialog
     title: "Please choose a color"
     onAccepted: {
         console.log("You chose: " + colorDialog.color)
         Qt.quit()
     }
     onRejected: {
         console.log("Canceled")
         Qt.quit()
     }
     Component.onCompleted: visible = true
 }

A ColorDialog window is automatically transient for its parent window. So whether you declare the dialog inside an Item or inside a Window, the dialog will appear centered over the window containing the item, or over the Window that you declared.

The implementation of ColorDialog will be a platform color dialog if possible. If that isn't possible, then it will try to instantiate a QColorDialog. If that also isn't possible, then it will fall back to a QML implementation, DefaultColorDialog.qml. In that case you can customize the appearance by editing this file. DefaultColorDialog.qml contains a Rectangle to hold the dialog's contents, because certain embedded systems do not support multiple top-level windows. When the dialog becomes visible, it will automatically be wrapped in a Window if possible, or simply reparented on top of the main window if there can only be one window.

Property Documentation

Method Documentation