Home · All Classes · Main Classes · Grouped Classes · Modules · Functions

Описание Класса QColorDialog
^{[модуль QtGui]}

Класс QColorDialog предоставляет виджет диалога для задания цвета. Далее...

#include <QColorDialog>

Наследует QDialog.

• Список всех членов, включая унаследованные
• Члены поддержки Qt 3

Статические Открытые Члены

• QRgb customColor ( int i )
• int customCount ()
• QColor getColor ( const QColor & initial = Qt::white, QWidget * parent = 0 )
• QRgb getRgba ( QRgb initial, bool * ok = 0, QWidget * parent = 0 )
• void setCustomColor ( int number, QRgb color )
• void setStandardColor ( int number, QRgb color )

• 4 статических открытых члена, унаследованные от QWidget
• 4 статических открытых члена, унаследованные от QObject

Дополнительные Унаследованные Члены

• 2 свойства, унаследованные от QDialog
• 54 свойства, унаследованные от QWidget
• 1 свойство, унаследованное от QObject
• 9 открытых функций, унаследованных от QDialog
• 188 открытых функций, унаследованных от QWidget
• 28 открытых функций, унаследованных от QObject
• 10 открытых функций, унаследованных от QPaintDevice
• 5 открытых слотов, унаследованных от QDialog
• 17 открытых слотов, унаследованных от QWidget
• 1 открытый слот, унаследованный от QObject
• 3 сигнала, унаследованных от QDialog
• 1 сигнал унаследованный от QWidget
• 1 сигнал унаследованный от QObject
• 39 защищенных функций унаследованных от QWidget
• 7 защищенных функций унаследованных от QObject

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

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

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

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

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

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

Дополнительные виджеты, позволяющие пользователю выбирать цвета можно получить в Qt Solutions.

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

Описание Функций-Членов

QRgb QColorDialog::customColor ( int i )   [static]

Возвращает пользовательский цвет с номером i как QRgb.

См. также setCustomColor().

int QColorDialog::customCount ()   [static]

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

QColor QColorDialog::getColor ( const QColor & initial = Qt::white, QWidget * parent = 0 )   [static]

Выводит модальный диалог выбора цвета, позволяющий пользователю указать цвет и возвращает этот цвет. Изначальный цвет устанавливается в initial. Диалог является дочерним объектом, по отношению к parent. Возвращает пустой цвет (см. QColor::isValid()) если пользователь отменяет выбор цвета. Все цвета размещенные в диалоге будут освобождены перед завершением функции.

QRgb QColorDialog::getRgba ( QRgb initial, bool * ok = 0, QWidget * parent = 0 )   [static]

Выводит модальный диалог выбора цвета, позволяющий пользователю указать цвет с альфа-каналом (каналом прозрачности) и возвращает этот цвет. Изначальные цвет и альфа-канал устанавливаются в initial. Диалог является дочерним объектом, по отношению к parent.

Если ok не является нулевым указателем, то *ok устанавливается в true, если пользователь нажал кнопку OK, и в false, если пользователь нажал кнопку Cancel.

Если пользователь нажал Cancel, то возвращается значение initial.

void QColorDialog::setCustomColor ( int number, QRgb color )   [static]

Устанавливает в качестве пользовательского цвета с номером number в значение QRgb color.

См. также customColor().

void QColorDialog::setStandardColor ( int number, QRgb color )   [static]

Устанавливает стандартный цвет с номером number в значение QRgb color.