Тип QML ColorDialog

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

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

Свойства

• цвет : цвет
• текущийЦвет : цвет
• режим : Qt::WindowModality
• показыватьАльфаКанал : bool
• заголовок : строка
• видимый : bool

Методы

• void закрыть()
• void открыть()

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

ColorDialog позволяет пользователю выбрать цвет. Диалог изначально невидим. Сначала необходимо установить необходимые свойства, а затем установить видимый в 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, диалог будет отображаться по центру над окном, содержащим элемент, или над окном Window, которое вы объявили.

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

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

цвет : цвет

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

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

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

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

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

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

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

режим : Qt::WindowModality

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

По умолчанию он равен Qt.NonModal.

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

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

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

показыватьАльфаКанал : bool

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

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

заголовок : строка

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

видимый : bool

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

См. также режим.

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

void закрыть()

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

void открыть()

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