Класс QColorDialog

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

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

Типы публичного доступа

Свойства

• currentColor : QColor
• options : ColorDialogOptions

• 2 свойства унаследованы от QDialog
• 59 свойств унаследовано от QWidget
• 1 свойство унаследовано от QObject

Функции публичного доступа

Переопределённые функции публичного доступа

• 8 функций публичного доступа унаследовано от QDialog
• 214 функций публичного доступа унаследовано от QWidget
• 34 функции публичного доступа унаследовано от QObject
• 14 функций публичного доступа унаследовано от QPaintDevice

Сигналы

• 3 сигнала унаследовано от QDialog
• 3 сигнала унаследовано от QWidget
• 2 сигнала унаследовано от QObject

Статические члены публичного доступа

• 5 статических членов публичного доступа унаследовано от QWidget
• 10 статических членов публичного доступа унаследовано от QObject

Переопределённые защищённые функции

• 6 защищённых функций унаследовано от QDialog
• 35 защищённых функций унаследовано от QWidget
• 9 защищённых функций унаследовано от QObject
• 1 защищённая функция унаследовано от QPaintDevice

Дополнительные унаследованные члены

• 5 public slots унаследовано от QDialog
• 19 public slots унаследовано от QWidget
• 1 public slot унаследовано от QObject
• 1 public переменная унаследовано от QObject
• 6 защищённых функций унаследовано от QDialog
• 35 защищённых функций унаследовано от QWidget
• 9 защищённых функций унаследовано от QObject
• 1 защищённая функция унаследовано от QPaintDevice
• 1 защищённый слот унаследовано от QWidget
• 2 защищённых переменных унаследовано от QObject
• 1 защищённый тип унаследовано от QPaintDevice

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

Класс QColorDialog предоставляет виджет диалога для выбора цвета.

Функция диалога выбора цвета — позволить пользователю выбрать цвет. Например, вы можете использовать его в программе рисования, чтобы позволить пользователю установить цвет кисти.

Статические функции предоставляют модальные диалоги выбора цвета.

Статическая функция getColor() отображает диалог и позволяет пользователю выбрать цвет. Эта функция также может быть использована для того, чтобы пользователи могли выбирать цвет с уровнем прозрачности: передайте опцию ShowAlphaChannel в качестве дополнительного аргумента.

Пользователь может хранить customCount() различных пользовательских цветов. Пользовательские цвета совместно используются всеми диалогами выбора цвета и запоминаются во время выполнения программы. Используйте setCustomColor() для установки пользовательских цветов и используйте customColor() для их получения.

При нажатии кнопки "Выбрать цвет экрана" курсор меняется на крестообразный, и сканируются цвета на экране. Пользователь может выбрать цвет, щелкнув по нему мышкой или нажав клавишу Enter. Нажатие клавиши Escape восстанавливает последний выбранный цвет перед входом в этот режим.

Пример Стандартные диалоги демонстрирует, как использовать QColorDialog, а также другие встроенные диалоги Qt.

См. также QColor, QFileDialog, QFontDialog и Пример стандартных диалогов.

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

перечисление QColorDialog::ColorDialogOptionфлаги QColorDialog::ColorDialogOptions

Это перечисление определяет различные параметры, которые влияют на внешний вид диалога выбора цвета.

Этот перечисление был введён или изменён в Qt 4.5.

Тип ColorDialogOptions — это typedef для QFlags<ColorDialogOption>. Он хранит результат побитового ИЛИ сочетания значений ColorDialogOption.

См. также options, setOption(), testOption() и windowModality().

Документация функций-членов

QColorDialog::QColorDialog(QWidget *parent = nullptr)

Конструирует диалог выбора цвета с заданным parent.

Эта функция была введена в Qt 4.5.

QColorDialog::QColorDialog(const QColor &initial, QWidget *parent = nullptr)

Конструирует диалог выбора цвета с заданным parent и заданным цветом initial.

Эта функция была введена в Qt 4.5.

[virtual] QColorDialog::~QColorDialog()

Удаляет диалог выбора цвета.

[override virtual protected] void QColorDialog::changeEvent(QEvent *e)

Переопределено из QWidget::changeEvent().

[signal] void QColorDialog::colorSelected(const QColor &color)

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

См. также color и currentColorChanged().

[signal] void QColorDialog::currentColorChanged(const QColor &color)

Этот сигнал генерируется всякий раз, когда текущий цвет изменяется в диалоге. Текущий цвет задаётся параметром color.

Примечание: Сигнал уведомления для свойства currentColor.

См. также color и colorSelected().

[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().

Закрывает диалог и устанавливает его код результата в 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 = ...)

Открывает модальный диалог выбора цвета с заданным заголовком окна 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; в противном случае сбрасывает указанный параметр.

См. также 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().

Изменяет видимость диалога. Если 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().