CHOOSECOLOR

CHOOSECOLOR структура містить інформацію, функція ChooseColor використовує ініціалізувати загальні діалоговому вікні Колір . Після того, як користувач закриває діалогове вікно, система повертає інформацію про вибір користувача у цій структурі.

typedef типу struct {/ / копія 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, спочатку виділений колір знаходиться чорний. Якщо натиснути кнопку "OK", rgbResult визначає колір користувача.

lpCustColors

Вказівник на масив 16 COLORREF значень, які містять червоний, зелений, синій (RGB) значення для власного кольору діалогових вікон у діалоговому вікні. Якщо користувач змінює ці кольори, система оновлення масив з нові значення RGB. Щоб зберегти нові власні кольори між дзвінки ChooseColor функції, слід виділити статичної пам'ять для масиву.

Прапори

Набір біт прапори, які можна використовувати для ініціалізації загальні діалоговому вікні Колір . Коли діалогове вікно повертається, він встановлює ці прапори вказати користувача вводу. Цей компонент може бути поєднання таких прапори:

Прапор	Значення
CC_ANYCOLOR	Викликає діалогове вікно Відображення всіх доступних кольорів у набір основних кольорів.
CC_ENABLEHOOK	Дозволяє гачок передбаченому lpfnHook членом цієї структури. Цей прапор використовується тільки для того, щоб ініціалізувати діалогове вікно.
CC_ENABLETEMPLATE	Вказує на те, що hInstance і lpTemplateName члени вказати діалоговому вікні шаблон для використання в якості шаблону за промовчанням. Цей прапор використовується тільки для того, щоб ініціалізувати діалогове вікно.
CC_ENABLETEMPLATEHANDLE	Вказує на те, що hInstance член ідентифікує блок даних, яка містить попередньо діалоговому вікні шаблон. Система ігнорує член 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

Курсор в рядок з нульовим, що імена в діалоговому вікні шаблон ресурс в модулі, визначені членами 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