На главную

On-line справка по Win32 API

Написать письмо
БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!
Список всех статей A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать Вниз

CHOOSECOLOR



The CHOOSECOLOR structure contains information the ChooseColor function uses to initialize the Color common dialog box. After the user closes the dialog box, the system returns information about the user's selection in this structure.

typedef struct { // cc
DWORD lStructSize;
HWND hwndOwner;
HWND hInstance;
COLORREF rgbResult;
COLORREF* lpCustColors;
DWORD Flags;
LPARAM lCustData;
LPCCHOOKPROC lpfnHook;
LPCTSTR lpTemplateName;
} CHOOSECOLOR;


Members

lStructSize

Specifies the length, in bytes, of the structure.

hwndOwner

Identifies the window that owns the dialog box. This member can be any valid window handle, or it can be NULL if the dialog box has no owner.

hInstance

If the CC_ENABLETEMPLATEHANDLE flag is set in the Flags member, hInstance is the handle of a memory object containing a dialog box template. If the CC_ENABLETEMPLATE flag is set, hInstance identifies a module that contains a dialog box template named by the lpTemplateName member. If neither CC_ENABLETEMPLATEHANDLE nor CC_ENABLETEMPLATE is set, this member is ignored.

rgbResult

If the CC_RGBINIT flag is set, rgbResult specifies the color initially selected when the dialog box is created. If the specified color value is not among the available colors, the system selects the nearest solid color available. If rgbResult is zero or CC_RGBINIT is not set, the initially selected color is black. If the user clicks the OK button, rgbResult specifies the user's color selection.

lpCustColors

Pointer to an array of 16 COLORREF values that contain red, green, blue (RGB) values for the custom color boxes in the dialog box. If the user modifies these colors, the system updates the array with the new RGB values. To preserve new custom colors between calls to the ChooseColor function, you should allocate static memory for the array.

Flags

A set of bit flags that you can use to initialize the Color common dialog box. When the dialog box returns, it sets these flags to indicate the user's input. This member can be a combination of the following flags:

Flag Meaning
CC_ENABLEHOOK Enables the hook procedure specified in the lpfnHook member of this structure. This flag is used only to initialize the dialog box.
CC_ENABLETEMPLATE Indicates that the hInstance and lpTemplateName members specify a dialog box template to use in place of the default template. This flag is used only to initialize the dialog box.
CC_ENABLETEMPLATEHANDLE Indicates that the hInstance member identifies a data block that contains a preloaded dialog box template. The system ignores the lpTemplateName member if this flag is specified. This flag is used only to initialize the dialog box.
CC_FULLOPEN Causes the dialog box to display the additional controls that allow the user to create custom colors. If this flag is not set, the user must click the Define Custom Color button to display the custom color controls.
CC_PREVENTFULLOPEN Disables the Define Custom Colors button.
CC_RGBINIT Causes the dialog box to use the color specified in the rgbResult member as the initial color selection.
CC_SHOWHELP Causes the dialog box to display the Help button. The hwndOwner member must specify the window to receive the HELPMSGSTRING registered messages that the dialog box sends when the user clicks the Help button.


lCustData

Specifies application-defined data that the system passes to the hook procedure identified by the lpfnHook member. When the system sends the WM_INITDIALOG message to the hook procedure, the message's lParam parameter is a pointer to the CHOOSECOLOR structure specified when the dialog was created. The hook procedure can use this pointer to get the lCustData value.

lpfnHook

Pointer to a CCHookProc hook procedure that can process messages intended for the dialog box. This member is ignored unless the CC_ENABLEHOOK flag is set in the Flags member.

lpTemplateName

Pointer to a null-terminated string that names the dialog box template resource in the module identified by the hInstance member. This template is substituted for the standard dialog box template. For numbered dialog box resources, lpTemplateName can be a value returned by the MAKEINTRESOURCE macro. This member is ignored unless the CC_ENABLETEMPLATE flag is set in the Flags member.



See Also

CCHookProc, ChooseColor, MAKEINTRESOURCE, WM_INITDIALOG


Пригласи друзей и счет твоего мобильника всегда будет положительным!
Предыдущая статья
 
Сайт Народ.Ру Интернет
Следующая статья
Пригласи друзей и счет твоего мобильника всегда будет положительным!

CHOOSECOLOR



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

typedef struct { // cc DWORD lStructSize;
HWND hwndOwner;
hInstance HWND;
COLORREF rgbResult;
COLORREF* lpCustColors;
DWORD СИГНАЛИЗИРУЕТ;
LPARAM lCustData;
LPCCHOOKPROC lpfnHook;
LPCTSTR lpTemplateName;
} CHOOSECOLOR;


Участники

lStructSize

Определяет длину, в байтах, структуры.

hwndOwner

Идентифицирует окно, которое обладает диалоговым блоком. Этот элемент может быть любой правильной ручкой окна, или это может быть НЕДЕЙСТВИТЕЛЬНО если диалоговый блок не имеет владельца.

hInstance

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

rgbResult

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

lpCustColors

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

Флаги

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

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


lCustData

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

lpfnHook

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

lpTemplateName

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



Смотри Также

CCHookProc, ChooseColor, MAKEINTRESOURCE, WM_INITDIALOG


Вверх Version 1.3, Oct 26 2010 © 2007, 2010, mrhx Вверх
 mrhx software  Русский перевод OpenGL  Русский перевод Win32 API
 
Используются технологии uCoz