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

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

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.