CHOOSECOLOR

Struktura CHOOSECOLOR zawiera informacje, używany przez funkcję ChooseColor zainicjować wspólne okno dialogowe kolorów . Po użytkownik zamyka okno dialogowe, system zwraca informacje o wybór użytkownika w tej struktury.

element TypeDef struct {/ / cm3 DWORD lStructSize; 
    HWND hwndOwner; 
    HWND wystąpienie hInstance; 
    COLORREF rgbResult; 
    COLORREF * lpCustColors; 
    DWORD Znaczników; 
    FIKCYJNYMI lCustData; 
    LPCCHOOKPROC lpfnHook; 
    LPCTSTR lpTemplateName; 
} CHOOSECOLOR 

 

Członkowie

lStructSize
Określa długość, w bajtach, struktury.
hwndOwner
Identyfikuje okno, w którym posiada okno dialogowe. Ten element może być dowolny uchwyt okna ważne lub go może być NULL, jeśli okno dialogowe bez właściciela.
wystąpienie hInstance
Jeżeli w Państwa flagi jest ustawiona flaga CC_ENABLETEMPLATEHANDLE, wystąpienie hInstance to dojście obiektu pamięci zawierającego szablon pole dialogowe. Jeśli jest ustawiona flaga CC_ENABLETEMPLATE, wystąpienie hInstance identyfikuje moduł, który zawiera szablon pole dialogowe o nazwie przez członka lpTemplateName . Jeśli ani CC_ENABLETEMPLATEHANDLE, ani CC_ENABLETEMPLATE nie jest ustawiona, członek ten jest ignorowany.
rgbResult
Jeśli jest ustawiona flaga CC_RGBINIT, rgbResult określa kolor początkowo wybrane podczas tworzenia okna dialogowego. Jeśli wartość określonego koloru nie jest spośród dostępnych kolorów, system wybierze najbliższy dostępny kolor kryjący. Jeśli rgbResult jest zero lub CC_RGBINIT nie jest ustawiona, początkowo wybranym kolorem jest czarny. Jeśli użytkownik kliknie przycisk OK, rgbResult Określa wybór koloru użytkownika.
lpCustColors
Wskaźnik do tablicy 16 wartości COLORREF, które zawierają czerwony, zielony i niebieski (RGB) wartości koloru niestandardowego pola w oknie dialogowym. Jeśli użytkownik zmienia kolory, system aktualizacji tablicy z nowych wartości RGB. Aby zachować nowe kolory niestandardowe między wywołaniami funkcji ChooseColor , należy przydzielić pamięci statycznej dla macierzy.
Flagi
Zestaw flag bitowych, które można zainicjować wspólne okno dialogowe kolorów . Gdy okno dialogowe zwraca, ustawia te flagi, aby wskazać dane wejściowe użytkownika. Ten element może być kombinacją następujących flag:
Flaga Znaczenie
CC_ANYCOLOR Powoduje, że okno dialogowe wyświetlić wszystkie dostępne kolory w zestawie kolorów podstawowych.
CC_ENABLEHOOK Umożliwia procedura haka, określona w lpfnHook członkiem tej struktury. Ta flaga jest stosowana tylko do zainicjowania okno dialogowe.
CC_ENABLETEMPLATE Wskazuje, że wystąpienie hInstance i lpTemplateName członków określić szablon pole dialogowe używać zamiast domyślnego szablonu. Ta flaga jest stosowana tylko do zainicjowania okno dialogowe.
CC_ENABLETEMPLATEHANDLE Wskazuje, że wystąpienie hInstance Członkowskich identyfikuje bloku danych, zawierający szablon pole dialogowe wstępnie. System ignoruje Państwa lpTemplateName , jeśli ta flaga jest określony. Ta flaga jest stosowana tylko do zainicjowania okno dialogowe.
CC_FULLOPEN Powoduje, że okno dialogowe wyświetlić dodatkowe formanty, które umożliwiają użytkownikowi tworzenie niestandardowych kolorów. Jeśli ta flaga nie jest ustawiona, użytkownik musi kliknij przycisk Definiujprzyciskkolor niestandardowydo wyświetlania formantów niestandardowych kolorów .
CC_PREVENTFULLOPEN Wyłącza przycisk Definiujkolory niestandardowe .
CC_RGBINIT Powoduje, że okno dialogowe użyć koloru określonego członka rgbResult jak dobór koloru początkowego.
CC_SHOWHELP Powoduje, że okno dialogowe wyświetlić przycisk Pomoc. Państwa hwndOwner należy określić, że okno, aby otrzymać HELPMSGSTRING zarejestrowane komunikaty, które okna dialogowego wysyła wówczas, gdy użytkownik kliknie przycisk Pomoc.
CC_SOLIDCOLOR Powoduje, że okno dialogowe wyświetlić tylko pełne kolory w zestawie kolorów podstawowych.

lCustData
Określa dane zdefiniowane przez aplikację, że system przechodzi do procedura haka zidentyfikowane przez członka lpfnHook . Gdy system wysyła komunikat WM_INITDIALOG procedura haka, wiadomości fikcyjnymi parametr jest wskaźnik do struktury CHOOSECOLOR określone podczas tworzenia okna dialogowego. Procedura haka można użyć tego wskaźnika aby uzyskać wartość lCustData.
lpfnHook
Wskaźnik CCHookProc spinanie procedury, który może przetwarzać wiadomości przeznaczonych dla okna dialogowego. Członek ten jest ignorowany, chyba że członek flagi jest ustawiona flaga CC_ENABLEHOOK.
lpTemplateName
Wskaźnik ciąg zakończony znakiem null, nazwy zasobu szablonu pole dialogowe w module zidentyfikowane przez członka wystąpienie hInstance . Ten szablon jest podstawiane szablonu pole standardowe okno dialogowe. Zasobów pole dialogowe numerowane lpTemplateName może być wartość zwracany przez makro MAKEINTRESOURCE . Członek ten jest ignorowany, chyba że członek flagi jest ustawiona flaga CC_ENABLETEMPLATE.

Skrócone informacje

nbsp; Windows &NT: wymagana wersja 3.1 lub nowsza.
Systemu Windows:Wymaga systemu Windows 95 lub nowszego.
Systemu Windows CE:Wymaga wersja 1.0 lub nowsza.
Nagłówka:Zadeklarowane w commdlg.h.
Unicode:Zdefiniowane jako struktur Unicode i ANSI.

Zobacz też

Wspólny omówienie biblioteki okna dialogowego, wspólnych struktur pole dialogowe, CCHookProc, ChooseColor, MAKEINTRESOURCE, WM_INITDIALOG