QML类型说明-ColorDialog

ColorDialog

ImportStatement:   import QtQuick.Dialogs 1.1

Since:  Qt 5.1

 

Properties

color :color

currentColor: color

modality :Qt::WindowModality

showAlphaChannel: bool

title :string

visible :bool

 

Methods

void close()

void open()

 

Detailed Description

ColorDialog允许我们选择一个眼色。这个对话框最初是不可见的，需要我们设置属性或调用open()让对话框可见。下面是一个打开颜色选择对话框并选择颜色后退出的代码。

importQtQuick 2.2

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

}

注意Component.onCompleted信号处理，我们基本上可以在所有的组件中，使用这个信号来进行一些我们对组件希望进行的初始化动作。

ColorDialog窗口自动关联和打开它的父窗口的瞬间状态。所以不管我们是在Item中还是Window中定义的ColorDialog。它就将在包含Item的窗口或我们定义的窗口中央出现。

ColorDialog是平台颜色窗口的实现，如果平台颜色窗口不可用，它实现为QColorDialog的实例，如果还不可用，它实现为QML的DefaultColorDialog.qml。在这种情形下，我们可以通过修改DefaultColorDialog.qml的内容来定制ColorDialog显示的内容。因为一些嵌入式系统不支持多个顶层窗口，ColorDialog显示的时候，会自动包装如窗口。如果只能显示一个窗口，ColorDialog简单的变成顶层窗口显示。

 

PropertyDocumentation

color :color

选择的颜色。注意它不总是和currentColor一样，因为在用户决定前，可能选择不同的颜色。

 

currentColor: color

用户当前选择的颜色。获得窗口被接受时的颜色使用color属性。

 

modality :Qt::WindowModality

窗口的模态。模态窗口指用户在采取有效的关闭手段之前，只能在该窗口操作。非模态窗口指用户可以切换到其他窗口操作。默认非模太。模态不意味着在模态窗口关闭之前，其他窗口式阻塞的。它仅仅指用户不能同时操作其他窗口。在MacOS中，颜色窗口只能是非模太的。

 

showAlphaChannel: bool

窗口是否提供透明度的改变。默认为真。它必须在打开窗口之前设置。通常透明度属性是一个附加的滑块控件表示。

 

title :string

窗口的标题。

 

visible :bool

窗口是否可视，默认为假，不可视。

 

MethodDocumentation

void close()

关闭颜色选择窗口。

 

void open()

向用户显示颜色窗口，等效于设置visible为真。