Тип QML ColorDialog

Компонент диалога для выбора цвета. Подробнее...

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

Свойства

• color : цвет
• currentColor : цвет
• modality : Qt::WindowModality
• showAlphaChannel : bool
• title : строка
• visible : bool

Методы

• void close()
• void open()

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

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

Вот минимальный пример открытия диалога выбора цвета и выхода после выбора пользователем цвета:

import QtQuick 2.2
import QtQuick.Dialogs 1.0

ColorDialog {
    id: colorDialog
    title: "Please choose a color"
    onAccepted: {
        console.log("You chose: " + colorDialog.color)
        Qt.quit()
    }
    onRejected: {
        console.log("Canceled")
        Qt.quit()
    }
    Component.onCompleted: visible = true
}

Окно ColorDialog автоматически является транзитным для своего родительского окна. Таким образом, независимо от того, объявляете ли вы диалог внутри Item или внутри Window, диалог будет отображаться по центру над окном, содержащим элемент, или над окном, которое вы объявили.

Реализация ColorDialog будет платформным диалогом выбора цвета, если это возможно. Если это невозможно, он попытается создать экземпляр QColorDialog. Если и это невозможно, он перейдет к реализации QML, DefaultColorDialog.qml. В этом случае вы можете настроить внешний вид, отредактировав этот файл. DefaultColorDialog.qml содержит Rectangle для размещения содержимого диалога, поскольку некоторые встраиваемые системы не поддерживают несколько окон верхнего уровня. При отображении диалога он автоматически будет обернут в Window, если это возможно, или просто переродится поверх основного окна, если может быть только одно окно.

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

color : цвет

Цвет, выбранный пользователем.

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

См. также currentColor.

currentColor : цвет

Цвет, который пользователь в данный момент выбрал.

Для цвета, который устанавливается при принятии диалога, используйте свойство color.

См. также color.

modality : Qt::WindowModality

Определяет, должен ли диалог отображаться как модальный по отношению к окну, содержащему родительский Item диалога, модальный по отношению ко всему приложению или немодальный.

По умолчанию это Qt.NonModal.

Модальность не означает, что есть какие-либо блокирующие вызовы ожидания принятия или отклонения диалога; это только означает, что пользователю будет запрещено взаимодействовать с родительским окном и/или окнами приложения одновременно.

Вероятно, вам нужно написать обработчик onAccepted, если вы хотите изменить цвет после того, как пользователь нажал кнопку «ОК», или обработчик onCurrentColorChanged, если вы хотите отреагировать на каждое изменение, которое пользователь вносит во время открытия диалога.

В MacOS диалог выбора цвета допускается только в немодальном режиме.

showAlphaChannel : bool

Определяет, будет ли диалог предоставлять возможность изменения непрозрачности.

По умолчанию это значение true. Это свойство должно быть установлено в нужное значение перед открытием диалога. Обычно канал альфа представлен дополнительным ползунком.

title : строка

Заголовок окна диалога.

visible : bool

Это свойство указывает, видимым ли является диалог. По умолчанию это false.

См. также modality.

Документация по методам

void close()

Закрывает диалог.

void open()

Отображает диалог пользователю. Эквивалентно установке visible в значение true.