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

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

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

color : цвет

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

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

См. также currentColor.

currentColor : цвет

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

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

См. также color.

modality : Qt::WindowModality

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

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

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

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

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

showAlphaChannel : bool

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

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

title : строка

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

visible : bool

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

См. также modality.

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

void close()

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

void open()

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