Тип QML ColorDialog

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

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

Свойства

• 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 не обновляется во время выбора цвета пользователем в диалоговом окне, а только после окончательного выбора. То есть, когда пользователь нажал OK, чтобы принять цвет. В качестве альтернативы можно обработать сигнал accepted() для получения окончательного выбора.

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

currentColor : цвет

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

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

См. также color.

options : флаги

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

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

Параметры должны быть заданы до отображения диалогового окна. Не гарантируется, что их изменение во время отображения диалогового окна немедленно повлияет на его внешний вид (в зависимости от параметра и платформы).

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