CHOOSECOLOR

CHOOSECOLOR структура содержит информацию, которую использует функцию ChooseColor для инициализации общее диалоговое окно . После того, как пользователь закрывает диалогового окна, система возвращает сведения о выборе пользователя в этой структуре.

typedef struct {/ / см3 DWORD lStructSize; 
    HWND hwndOwner; 
    HWND hInstance; 
    COLORREF rgbResult; 
    COLORREF * lpCustColors; 
    DWORD Флаги; 
    LPARAM lCustData; 
    LPCCHOOKPROC lpfnHook; 
    LPCTSTR lpTemplateName; 
} CHOOSECOLOR 
 

Члены

lStructSize

Задает длину в байтах структуры.

hwndOwner

Идентифицирует окно, которому принадлежит диалогового окна. Этот член может быть любой допустимый дескриптор, или это может быть значение NULL, если диалогового окна не имеет собственника.

hInstance

Если флаг CC_ENABLETEMPLATEHANDLE установлен в странах-членах флаги , hInstance является дескриптор объекта памяти, содержащий шаблон поля диалогового окна. Если установлен флаг CC_ENABLETEMPLATE, hInstance определяет модуль, содержащий диалоговое окно поле шаблон с именем lpTemplateName членов. Если ни CC_ENABLETEMPLATEHANDLE, ни CC_ENABLETEMPLATE не задано, этот элемент пропускается.

rgbResult

Если установлен флаг CC_RGBINIT, rgbResult определяет цвет, первоначально выбранный при создании диалогового окна. Если указанное значение не является среди доступных цветов, система выбирает ближайший сплошной цвет. Если rgbResult равен нулю или CC_RGBINIT не задано, первоначально выбранный цвет — черный. Если пользователь нажимает кнопку ОК, rgbResult определяет пользовательский выбор цвета.

lpCustColors

Указатель на массив 16 COLORREF значений, которые содержат значения красного, зеленого, синего (RGB) для пользовательской цветовой коробки в диалоговом окне. Если пользователь изменяет эти цвета, система обновляет массив с новыми значениями RGB. Для сохранения новых пользовательских цветов между вызовами функции ChooseColor , следует выделить статическая память для массива.

Флаги

Набор битовых флагов, которые можно использовать для инициализации общее диалоговое окно . По возвращении из диалогового окна он устанавливает эти флаги для указания пользовательского ввода. Этот член может быть комбинацией следующих флагов:

Флаг	Значение
CC_ANYCOLOR	Вызывает диалоговое окно для отображения всех доступных цветов в наборе основных цветов.
CC_ENABLEHOOK	Включает процедуру подключения, указанный в lpfnHook член этой структуры. Этот флаг используется только для инициализации диалогового окна.
CC_ENABLETEMPLATE	Указывает, что hInstance и lpTemplateName члены указать шаблон поля диалогового окна для использования вместо шаблона по умолчанию. Этот флаг используется только для инициализации диалогового окна.
CC_ENABLETEMPLATEHANDLE	Указывает, что член hInstance определяет блок данных, содержащего шаблон box предустановленной диалогового окна. Система игнорирует lpTemplateName члена, если этот флаг указан. Этот флаг используется только для инициализации диалогового окна.
CC_FULLOPEN	Вызывает диалоговое окно для отображения дополнительных элементов управления, которые позволяют пользователю для создания настраиваемых цветов. Если этот флаг не установлен, пользователь должен нажать определить пользовательские цвета для отображения на кнопке пользовательский цвет элементов управления.
CC_PREVENTFULLOPEN	Отключает кнопку определитьпользовательскиецвета .
CC_RGBINIT	Вызывает диалоговое окно "" использовать цвет, указанный в rgbResult член как выбор первоначального цвета.
CC_SHOWHELP	Вызывает диалоговое окно для отображения кнопки справки. Член hwndOwner необходимо указать окно, чтобы получить HELPMSGSTRING зарегистрированы сообщения отправляемые диалогового окна, когда пользователь нажимает кнопку Справка.
CC_SOLIDCOLOR	Вызывает диалоговое окно для отображения только сплошные цвета в наборе основных цветов.

lCustData

Задает определяемые приложением данные, которые система проходит процедуру подключения определенных членов lpfnHook . Когда система отправляет сообщение WM_INITDIALOG процедуру подключения, параметр lParam сообщения является указатель на структуру CHOOSECOLOR , указанного при создании диалогового окна. Для получения lCustData значение этого указателя можно использовать процедуру подключения.

lpfnHook

Указатель на CCHookProc крюк процедуру, которая может обрабатывать сообщения, предназначенные для диалогового окна. Этот элемент игнорируется, если только флаг CC_ENABLEHOOK установлен в странах-членах флаги.

lpTemplateName

Указатель на ограниченную значением null строку, которая содержит название ресурсе шаблона диалогового окна поля в модуле, выявленные hInstance члена. Этот шаблон будет вместо стандартного диалогового окна поля шаблона. Для пронумерованных диалогового окна ресурсов lpTemplateName может быть значение, возвращенное макрос MAKEINTRESOURCE . Этот элемент игнорируется, если только флаг CC_ENABLETEMPLATE установлен в странах-членах флаги.

QuickInfo

nbsp; Windows &NT: требует версии 3.1 или более поздней версии.
Windows:Требует Windows 95 или более поздней версии.
Windows CE:Требует версии 1.0 или более поздней версии.
Заголовок:Объявленные в commdlg.h.
Юникод:Определяется как структуры Unicode и ANSI.

Родственные слова

Общие диалогового окна Обзор библиотеки, Общие диалоговое окно окно структуры, CCHookProc, ChooseColor, MAKEINTRESOURCE, WM_INITDIALOG

Index