Класс QColorDialog
Класс QColorDialog предоставляет виджет диалога для задания цветов. Подробнее...
| Заголовок: | #include <QColorDialog> |
| qmake: | QT += widgets |
| Наследует: | QDialog |
Типы публичного доступа
| перечисление | ColorDialogOption { ShowAlphaChannel, NoButtons, DontUseNativeDialog } |
| флаги | ColorDialogOptions |
Свойства
- currentColor : QColor
- options : ColorDialogOptions
Функции публичного доступа
| QColorDialog(const QColor &initial, QWidget *parent = nullptr) | |
| QColorDialog(QWidget *parent = nullptr) | |
| virtual | ~QColorDialog() |
| QColor | currentColor() const |
| void | open(QObject *receiver, const char *member) |
| QColorDialog::ColorDialogOptions | options() const |
| QColor | selectedColor() const |
| void | setCurrentColor(const QColor &color) |
| void | setOption(QColorDialog::ColorDialogOption option, bool on = true) |
| void | setOptions(QColorDialog::ColorDialogOptions options) |
| bool | testOption(QColorDialog::ColorDialogOption option) const |
Переопределенные функции публичного доступа
| virtual void | setVisible(bool visible) override |
Сигналы
| void | colorSelected(const QColor &color) |
| void | currentColorChanged(const QColor &color) |
Статические члены публичного доступа
| QColor | customColor(int index) |
| int | customCount() |
| QColor | getColor(const QColor &initial = Qt::white, QWidget *parent = nullptr, const QString &title = QString(), QColorDialog::ColorDialogOptions options = ColorDialogOptions()) |
| void | setCustomColor(int index, QColor color) |
| void | setStandardColor(int index, QColor color) |
| QColor | standardColor(int index) |
Переопределённые защищённые функции
| virtual void | changeEvent(QEvent *e) override |
| virtual void | done(int result) override |
Подробное описание
Функция диалога выбора цвета предназначена для того, чтобы пользователи могли выбирать цвета. Например, вы можете использовать его в программе рисования, чтобы позволить пользователю задать цвет кисти.
Статические функции предоставляют модальные диалоги выбора цвета.
Статическая функция getColor() отображает диалог и позволяет пользователю указать цвет. Эта функция также может использоваться для того, чтобы пользователи могли выбирать цвет с уровнем прозрачности: передайте опцию ShowAlphaChannel в качестве дополнительного аргумента.
Пользователь может хранить customCount() различных пользовательских цветов. Пользовательские цвета общие для всех диалогов выбора цвета и сохраняются во время выполнения программы. Используйте setCustomColor() для задания пользовательских цветов и customColor() для их получения.
При нажатии на кнопку «Выбрать цвет экрана» курсор меняется на перекрестие, и цвета на экране сканируются. Пользователь может выбрать цвет, щелкнув по нему мышью или нажав клавишу Enter. Нажатие клавиши Escape восстанавливает последний выбранный цвет перед входом в этот режим.
Пример Стандартные диалоги демонстрирует использование QColorDialog, а также других встроенных диалогов Qt.
См. также QColor, QFileDialog, QFontDialog и Пример Стандартные диалоги.
Документация по типам членов
перечисление QColorDialog::ColorDialogOptionфлаги QColorDialog::ColorDialogOptions
Это перечисление определяет различные опции, которые влияют на вид и поведение диалога выбора цвета.
| Постоянная | Значение | Описание |
|---|---|---|
QColorDialog::ShowAlphaChannel |
0x00000001 |
Разрешить пользователю выбрать альфа-компонент цвета. |
QColorDialog::NoButtons |
0x00000002 |
Не отображать кнопки «ОК» и «Отмена». (Полезно для «живых диалогов».) |
QColorDialog::DontUseNativeDialog |
0x00000004 |
Использовать стандартный диалог выбора цвета Qt вместо диалога выбора цвета операционной системы. |
Это перечисление было введено или изменено в Qt 4.5.
Тип ColorDialogOptions — это псевдоним для QFlags<ColorDialogOption>. Он хранит логическое ИЛИ сочетание значений ColorDialogOption.
См. также options, setOption(), testOption() и windowModality().
Документация по свойствам
currentColor : QColor
Это свойство хранит текущий выбранный цвет в диалоговом окне.
Функции доступа:
| QColor | currentColor() const |
| void | setCurrentColor(const QColor &color) |
Сигнал уведомления:
| void | currentColorChanged(const QColor &color) |
options : ColorDialogOptions
Это свойство хранит различные параметры, влияющие на вид диалогового окна.
По умолчанию все параметры отключены.
Параметры должны быть установлены перед отображением диалогового окна. Установка параметров во время видимости диалогового окна не гарантирует немедленного влияния на диалог (в зависимости от параметра и платформы).
Функции доступа:
| QColorDialog::ColorDialogOptions | options() const |
| void | setOptions(QColorDialog::ColorDialogOptions options) |
См. также setOption() и testOption().
Документация по членам-функциям
QColorDialog::QColorDialog(const QColor &initial, QWidget *parent = nullptr)
Создаёт диалоговое окно выбора цвета с заданным parent и указанным начальным цветом initial.
Эта функция была введена в Qt 4.5.
QColorDialog::QColorDialog(QWidget *parent = nullptr)
Создаёт диалоговое окно выбора цвета с заданным parent.
Эта функция была введена в Qt 4.5.
[signal] void QColorDialog::colorSelected(const QColor &color)
Этот сигнал испускается сразу после того, как пользователь нажал кнопку ОК для выбора цвета. Выбранный цвет указан параметром color.
См. также color и currentColorChanged().
[signal] void QColorDialog::currentColorChanged(const QColor &color)
Этот сигнал испускается всякий раз, когда текущий цвет изменяется в диалоговом окне. Текущий цвет указан параметром color.
Примечание: Сигнал уведомления для свойства currentColor.
См. также color и colorSelected().
[virtual] QColorDialog::~QColorDialog()
Удаляет диалоговое окно выбора цвета.
[override virtual protected] void QColorDialog::changeEvent(QEvent *e)
Переопределяет: QWidget::changeEvent(QEvent *event).
[static] QColor QColorDialog::customColor(int index)
Возвращает пользовательский цвет по заданному index в виде значения QColor.
Эта функция была введена в Qt 4.5.
См. также setCustomColor().
[static] int QColorDialog::customCount()
Возвращает количество поддерживаемых пользовательских цветов QColorDialog. Все диалоговые окна выбора цвета используют одни и те же пользовательские цвета.
[override virtual protected] void QColorDialog::done(int result)
Переопределяет: QDialog::done(int r).
Закрывает диалоговое окно и устанавливает его код результата в result. Если это диалоговое окно показано с помощью exec(), done() завершает локальный цикл событий и exec() возвращает result.
См. также QDialog::done().
[static] QColor QColorDialog::getColor(const QColor &initial = Qt::white, QWidget *parent = nullptr, const QString &title = QString(), QColorDialog::ColorDialogOptions options = ColorDialogOptions())
Выводит модальное диалоговое окно выбора цвета с заданным заголовком окна title (или «Выбор цвета», если не указано), позволяет пользователю выбрать цвет и возвращает этот цвет. Цвет по умолчанию установлен в initial. Диалоговое окно является дочерним элементом parent. Возвращает недопустимый (см. QColor::isValid()) цвет, если пользователь отменяет диалоговое окно.
Аргумент options позволяет настроить диалоговое окно.
Эта функция была введена в Qt 4.5.
void QColorDialog::open(QObject *receiver, const char *member)
Открывает диалоговое окно и подключает его сигнал colorSelected() к слоту, указанному параметрами receiver и member.
Сигнал будет отключен от слота при закрытии диалогового окна.
Эта функция была введена в Qt 4.5.
QColor QColorDialog::selectedColor() const
Возвращает цвет, который пользователь выбрал, нажав кнопку ОК или аналогичную.
Примечание: Этот цвет не всегда совпадает с цветом, хранящимся в свойстве currentColor, так как пользователь может выбрать различные цвета, прежде чем окончательно выбрать используемый цвет.
[static] void QColorDialog::setCustomColor(int index, QColor color)
Устанавливает пользовательский цвет в index на значение QColor color.
Примечание: Эта функция не применяется к диалоговому окну выбора цвета по умолчанию на платформе macOS. Если вам всё равно требуется эта функция, используйте параметр QColorDialog::DontUseNativeDialog.
См. также customColor().
void QColorDialog::setOption(QColorDialog::ColorDialogOption option, bool on = true)
Устанавливает заданный option в состояние включения, если on равно true; в противном случае очищает заданный option.
См. также options и testOption().
[static] void QColorDialog::setStandardColor(int index, QColor color)
Устанавливает стандартный цвет в index на значение QColor color.
Примечание: Эта функция не применяется к диалоговому окну выбора цвета по умолчанию на платформе macOS. Если вам всё равно требуется эта функция, используйте параметр QColorDialog::DontUseNativeDialog.
См. также standardColor().
[override virtual] void QColorDialog::setVisible(bool visible)
Переопределяет: QDialog::setVisible(bool visible).
Изменяет видимость диалогового окна. Если visible равно true, диалоговое окно отображается; в противном случае оно скрывается.
[static] QColor QColorDialog::standardColor(int index)
Возвращает стандартный цвет по заданному index в виде значения QColor.
Эта функция была введена в Qt 5.0.
См. также setStandardColor().
bool QColorDialog::testOption(QColorDialog::ColorDialogOption option) const
Возвращает true, если заданный option включен; в противном случае возвращает false.
Эта функция была введена в Qt 4.5.
См. также options и setOption().
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-5.14/qcolordialog.html
