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

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

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

Свойства

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

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

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

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

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 app(argc, argv);
    QQmlApplicationEngine engine;
    engine.load(QUrl(QStringLiteral("qrc:/main.qml")));
    return app.exec();
}

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

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

цвет : цвет

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

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

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

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

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

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

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

параметры : флаги

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

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

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

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