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

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

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

Свойства

• color : цвет
• currentColor : цвет
• options : флаги

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

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

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

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 : цвет

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

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

См. также currentColor и accepted().

currentColor : цвет

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

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

См. также color.

options : флаги

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

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

Параметры следует устанавливать до отображения диалогового окна. Установка параметров во время отображения диалогового окна не гарантирует немедленного эффекта (в зависимости от параметра и платформы).

Доступные параметры: