Класс 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 |
Не отображать кнопки OK и Отмена. (Полезно для «динамических диалогов».) |
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.15/qcolordialog.html
