CHOOSECOLOR

Structura CHOOSECOLOR conţine informaţii funcţia de ChooseColor utilizează pentru a iniţializa caseta culoare de dialog comune. După ce utilizatorul se închide caseta de dialog, sistemul întoarce informaţii despre selecţia utilizatorului în această structură.

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

 

Membrii

lStructSize

Specifică lungimea, în octeţi, structurii.

hwndOwner

Identifică fereastra care deţine caseta de dialog. Acest membru poate fi orice fereastră valabil mâner, sau poate fi nul în cazul în care caseta de dialog a nu proprietar.

hInstance

Dacă pavilion CC_ENABLETEMPLATEHANDLE este stabilit în membre steaguri , hInstance este ghidajul de un obiect de memorie care con?in un şablon de caseta de dialog. Dacă pavilion CC_ENABLETEMPLATE este setat, hInstance identifică un modul care conţine un şablon de caseta de dialog numit de statul membru de lpTemplateName . Dacă este setat nici CC_ENABLETEMPLATEHANDLE, nici CC_ENABLETEMPLATE, acest membru este ignorat.

rgbResult

Dacă pavilion CC_RGBINIT este setat, rgbResult specifică culoarea selectată iniţial atunci când caseta de dialog este creat. Dacă valoarea culoare specificată nu este printre culorile disponibile, sistemul selectează cea mai apropiată culoare solidă disponibile. În cazul în care rgbResult este zero sau CC_RGBINIT nu este setată, culoarea selectată iniţial este negru. În cazul în care utilizatorul face clic pe butonul OK, rgbResult specifică utilizatorului culoare selecţie.

lpCustColors

Indicator spre o matrice de valori COLORREF 16 care conţin roşu, verde, albastru (RGB) valorile pentru culoarea particularizată casetele din caseta de dialog. Dacă utilizatorul modifică aceste culori, sistemul actualizează matrice cu valorile RGB. Pentru a păstra noi culori particularizate între apelurile la funcţia de ChooseColor , ar trebui să alocaţi memoria statică pentru matrice.

Steaguri

Un set de steaguri de biţi care le puteţi utiliza pentru a iniţializa caseta culoare de dialog comune. Când se întoarce în caseta de dialog, se setează aceste semnalizări pentru a indica utilizatorului intrare. Acest membru pot fi o combinatie dintre steagurile de următoarele:

Drapelul	Sensul
CC_ANYCOLOR	Cauzele caseta de dialog pentru a afişa toate culorile disponibile în setul de culori de bază.
CC_ENABLEHOOK	Permite cârlig procedura specificată în lpfnHook membre de această structură. Acest flag este utilizat numai pentru a iniţializa caseta de dialog.
CC_ENABLETEMPLATE	Indică faptul că membrii hInstance şi lpTemplateName specificat un şablon de caseta de dialog pentru a utiliza în loc de şablonul implicit. Acest flag este utilizat numai pentru a iniţializa caseta de dialog.
CC_ENABLETEMPLATEHANDLE	Indică faptul că hInstance membre identifică un bloc de date care conţine un şablon de caseta de preloaded dialog. Sistemul ignoră membru lpTemplateName dacă acest flag este specificat. Acest flag este utilizat numai pentru a iniţializa caseta de dialog.
CC_FULLOPEN	Cauzele caseta de dialog pentru a afişa comenzile suplimentare care permite utilizatorului de a crea culori personalizate. Dacă acest flag nu este setată, utilizatorul trebuie să faceţi clic pe butonulculoare personalizatede Definirepentru a afişa comenzile culoare particularizată .
CC_PREVENTFULLOPEN	Dezactivează butonul DefinireCustomculori .
CC_RGBINIT	Cauzele caseta de dialog pentru a utiliza culoarea specificată în membre rgbResult ca selecţia iniţială de culoare.
CC_SHOWHELP	Cauzele caseta de dialog pentru a afişa butonul ajutor. Membru hwndOwner trebuie să specificaţi fereastra pentru a primi HELPMSGSTRING înregistrat mesaje care caseta de dialog trimite atunci când utilizatorul face clic pe butonul Ajutor.
CC_SOLIDCOLOR	Cauzele caseta de dialog pentru a afişa numai solide culori în set de culori de bază.

lCustData

Specifică date definite de aplicarea că sistemul trece la procedura cârlig identificate de către lpfnHook . Atunci când sistemul trimite mesajul WM_INITDIALOG procedura cârlig, mesajul lui lParam parametru este un indicator de structura CHOOSECOLOR specificat când dialogul a fost creat. Procedura cârlig poate utiliza acest indicator pentru a obţine valoarea lCustData.

lpfnHook

Indicatorul pentru a o CCHookProc cârlig procedura care poate procesa mesaje destinate pentru caseta de dialog. Acest membru este ignorată dacă pavilion CC_ENABLEHOOK este setat în membre steaguri.

lpTemplateName

Indicatorul un şir null-terminated care nume de caseta de dialog şablon resursa în modulul identificate de către hInstance . Acest şablon este înlocuit pentru şablonul de caseta de standard dialog. Pentru resurse caseta de dialog numerotare, lpTemplateName poate fi o valoare returnată de macrocomanda MAKEINTRESOURCE . Acest membru este ignorată dacă pavilion CC_ENABLETEMPLATE este setat în membre steaguri.

QuickInfo

nbsp; Windows &NT: necesită versiunea 3.1 sau mai târziu.
Windows:Necesită Windows 95 sau o versiune ulterioară.
Windows CE:Necesită versiunea 1.0 sau mai târziu.
Antet:A declarat în commdlg.h.
Unicode:Definit ca structurile Unicode şi ANSI.

A se vedea, de asemenea

Comune Dialog casetă de prezentare biblioteca, structuri comune de caseta de Dialog, CCHookProc, ChooseColor, MAKEINTRESOURCE, WM_INITDIALOG