CHOOSECOLOR

CHOOSECOLOR -strukturen inneholder informasjon som ChooseColor -funksjonen bruker til å initialisere felles dialogboksen farge . Når brukeren lukker dialogboksen, returnerer systemet informasjon om brukerens valg i denne strukturen.

typeDef struct {/ / kopi DWORD lStructSize; 
    HWND hwndOwner; 
    HWND hInstance; 
    COLORREF rgbResult; 
    COLORREF * lpCustColors; 
    DWORD Flagg; 
    LPARAM lCustData; 
    LPCCHOOKPROC lpfnHook; 
    LPCTSTR lpTemplateName; 
} CHOOSECOLOR 

 

Medlemmer

lStructSize

Angir lengden, i byte, på strukturen.

hwndOwner

Identifiserer vinduet som eier dialogboksen. Dette medlemmet kan være en hvilken som helst gyldig vindus-handle, eller det kan være NULL Hvis dialogboksen har ingen eier.

hInstance

Hvis flagget CC_ENABLETEMPLATEHANDLE er angitt i flagg -medlem, er hInstance håndtak av en minne-objekt som inneholder en mal for dialogboksen-boksen. Hvis flagget CC_ENABLETEMPLATE er angitt, identifiserer hInstance en modul som inneholder en dialog boks mal med navnet av lpTemplateName -medlemmet. Dette medlemmet ignoreres hvis verken CC_ENABLETEMPLATEHANDLE eller CC_ENABLETEMPLATE er angitt,.

rgbResult

Hvis flagget CC_RGBINIT er angitt, angir fargen som er valgt først når dialogboksen opprettes i rgbResult . Hvis den angitte fargeverdien ikke er blant de tilgjengelige fargene, velger systemet den nærmeste heldekkende fargen som er tilgjengelig. Hvis rgbResult er null eller CC_RGBINIT er ikke angitt, vil utgangspunktet valgt farge er svart. Hvis brukeren klikker OK-knappen, angir rgbResult brukerens fargevalget.

lpCustColors

Pekeren til en matrise med 16 COLORREF verdier som inneholder verdier for rød, grønn og blå (RGB) for den egendefinerte fargen boksene i dialogboksen. Hvis brukeren endrer disse fargene, oppdaterer systemet matrisen med de nye RGB-verdiene. Hvis du vil beholde nye egendefinerte farger mellom kall til funksjonen ChooseColor , bør du tildele statisk minne for matrise.

Flagg

Et sett med Bitflagg som du kan bruke til å initialisere felles dialogboksen farge . Når dialogboksen returnerer, setter det disse flaggene for å angi brukerens inndata. Dette medlemmet kan være en kombinasjon av følgende flagg:

Flagg	Betydning
CC_ANYCOLOR	Åpner dialogboksen til å vise alle tilgjengelige farger i grunnleggende fargene.
CC_ENABLEHOOK	Aktiverer hook-prosedyre som er angitt i lpfnHook -medlem av denne strukturen. Dette flagget brukes bare til å initialisere dialogboksen.
CC_ENABLETEMPLATE	Angir at hInstance og lpTemplateName -medlemmer angir en dialog boks mal som skal brukes i stedet for standardmalen. Dette flagget brukes bare til å initialisere dialogboksen.
CC_ENABLETEMPLATEHANDLE	Angir at medlemmet hInstance identifiserer en datablokk som inneholder en mal for forhåndslagrede dialogboksen-boksen. Systemet ignorerer medlemmet lpTemplateName Hvis dette flagget er angitt. Dette flagget brukes bare til å initialisere dialogboksen.
CC_FULLOPEN	Fører til dialogboksen for å vise flere kontroller som lar brukeren å opprette egendefinerte farger. Hvis dette flagget ikke er angitt, må brukeren klikke Definer egendefinerte fargeknappen for å vise de egendefinerte fargekontroller.
CC_PREVENTFULLOPEN	Deaktiverer Definer egendefinerte farger -knappen.
CC_RGBINIT	Åpner dialogboksen å bruke fargen som er angitt i rgbResult -medlem som det opprinnelige fargevalget.
CC_SHOWHELP	Fører til dialogboksen for å vise Hjelp-knappen. HwndOwner -medlem må angi i vinduet for å motta HELPMSGSTRING registrert meldinger som dialogboksen sender når brukeren klikker Hjelp -knappen.
CC_SOLIDCOLOR	Åpner dialogboksen til å vise bare heldekkende farger i grunnleggende fargene.

lCustData

Angir en programdefinert data som systemet sender til Bindingsprosedyren identifisert av lpfnHook -medlemmet. Når systemet sender meldingen WM_INITDIALOG til Bindingsprosedyren, er meldingens lParam -parameteren en peker til CHOOSECOLOR strukturen angitt da dialogboksen ble opprettet. Bindingsprosedyren kan bruke denne pekeren til å hente verdien lCustData.

lpfnHook

Pekeren til en CCHookProc hook-prosedyre som kan behandle meldinger som er ment for dialogboksen. Dette medlemmet ignoreres hvis ikke flagget CC_ENABLEHOOK er angitt i flagg -medlem.

lpTemplateName

Pekeren til en null-terminert streng som navngir dialogboksen boksen mal ressurs i modulen identifisert av hInstance -medlemmet. Denne malen er erstattet med malen standard dialog-boksen. For nummererte dialogboksen boksen ressurser, kan lpTemplateName være en verdi returneres av MAKEINTRESOURCE -makroen. Dette medlemmet ignoreres hvis ikke flagget CC_ENABLETEMPLATE er angitt i flagg -medlem.

Hurtiginformasjon

nbsp; Windows &NT: krever versjon 3.1 eller senere.
Windows:Krever Windows 95 eller senere.
Windows CE:Krever versjon 1.0 eller senere.
Topptekst:Deklarert i commdlg.h.
Unicode:Definert som Unicode- og ANSI-strukturer.

Se også

Felles biblioteket dialogboksoversikt, felles dialogboksen boksen strukturer, CCHookProc, ChooseColor, MAKEINTRESOURCE, WM_INITDIALOG