ColorDialog QML 类型

本地颜色对话框。更多信息...

导入声明	import Qt.labs.platform
继承	Dialog

包含所有成员的列表，包括继承的成员

属性

color : color
currentTime : color
options : flags

详细说明

ColorDialog 类型提供了原生平台颜色对话框的 QML API。

要显示颜色对话框，构造 ColorDialog 实例，设置所需的属性，并调用 open() 方法。可以使用 currentTime 属性确定对话框中当前选中颜色。在最终选择后被接受后，才会更新 color 属性。

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

ColorDialog {
    id: colorDialog
    currentColor: document.color
}

MyDocument {
    id: document
    color: colorDialog.color
}

可用性

原生平台颜色对话框目前可在以下平台使用

iOS
Linux（当使用 GTK+ 平台主题运行时）
macOS

Qt Labs 平台模块在未提供原生实现的平台上使用 Qt Widgets 作为后备方案。因此，使用来自 Qt Labs 平台模块的类型的应用程序应链接到 QtWidgets，并使用 QApplication 而不是 QGuiApplication。

要链接到 QtWidgets 库，向您的 qmake 项目文件中添加以下内容

QT += widgets

在 main() 中创建 QApplication 的实例

#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();
}

注意：Qt.labs 模块中的类型在未来的版本中可能无法保证兼容性。

属性文档

color : color

此属性包含最终接受的颜色。

与 currentTime 属性不同，color 属性在用户在对话框中选择颜色时不会更新，仅在用户确认选择后才更新。也就是说，当用户单击 OK 以接受颜色时。或者，可以通过处理 accepted() 信号来获取最终选择。

另请参阅currentTime 和 accepted。

currentTime : color

此属性包含对话框中当前选中的颜色。

与颜色属性不同，当用户在对话框中选取颜色时，即使在最终选择之前，currentColor属性也会被更新。

另请参阅颜色。

选项 : 标志

此属性包含影响对话框外观和感觉的不同选项。

默认情况下，所有选项均被禁用。

应在显示对话框之前设置选项。在对话框可见时设置它们可能不会立即影响对话框（取决于选项和平台）。

可用选项

常量	描述
`ColorDialog.ShowAlphaChannel`	允许用户选择颜色的alpha组件。
`ColorDialog.NoButtons`	不显示确定和取消按钮（对于“实时对话框”很有用）。