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