Диалоговое окно выбора цвета QML

Нативное диалоговое окно выбора цвета. Подробнее...

• Список всех членов, включая унаследованные

Свойства

• цвет : цвет
• текущийЦвет : цвет
• опции : флаги

Подробное описание

Тип ColorDialog предоставляет QML API для нативных диалоговых окон выбора цвета на разных платформах.

Чтобы отобразить диалоговое окно выбора цвета, создайте экземпляр ColorDialog, задайте необходимые свойства и вызовите open(). Свойство текущийЦвет используется для определения текущего выбранного цвета в диалоговом окне. Свойство цвет обновляется только после окончательного выбора цвета, когда пользователь нажимает «OK».

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

ColorDialog {
    id: colorDialog
    currentColor: document.color
}

MyDocument {
    id: document
    color: colorDialog.color
}

Доступность

Нативные диалоговые окна выбора цвета доступны на следующих платформах:

• macOS
• Linux (при использовании темы GTK+)

Модуль Qt Labs Platform использует Qt Widgets в качестве резервного варианта на платформах, где нет нативной реализации. Поэтому приложения, использующие типы из модуля Qt Labs Platform, должны ссылаться на QtWidgets и использовать QApplication вместо QGuiApplication.

Для ссылки на библиотеку QtWidgets добавьте следующее в файл проекта qmake:

QT += widgets

Создайте экземпляр QApplication в main():

#include <QApplication>
#include <QQmlApplicationEngine>

int main(int argc, char *argv[])
{
    QApplication::setAttribute(Qt::AA_EnableHighDpiScaling);
    QApplication app(argc, argv);
    QQmlApplicationEngine engine;
    engine.load(QUrl(QStringLiteral("qrc:/main.qml")));
    return app.exec();
}

Примечание:Типы в модулях Qt.labs не гарантируют совместимость в будущих версиях.

Документация по свойствам

цвет : цвет

Это свойство хранит окончательно выбранный цвет.

В отличие от свойства текущийЦвет, свойство color не обновляется во время выбора цвета в диалоговом окне, а только после окончательного выбора. То есть, когда пользователь нажимает кнопку «OK» для подтверждения выбора цвета. В качестве альтернативы, можно обработать сигнал accepted() для получения окончательного выбора.

См. также текущийЦвет и accepted().

текущийЦвет : цвет

Это свойство хранит текущий выбранный цвет в диалоговом окне.

В отличие от свойства цвет, свойство currentColor обновляется во время выбора цвета пользователем в диалоговом окне, даже до окончательного выбора.

См. также цвет.

опции : флаги

Это свойство хранит различные опции, влияющие на внешний вид диалогового окна.

По умолчанию все опции отключены.

Опции должны быть заданы до отображения диалогового окна. Задание опций во время отображения диалогового окна не гарантирует немедленного изменения в его внешнем виде (в зависимости от опции и платформы).

Доступные опции: