ChooseColor

ChooseColor -funksjonen oppretter en felles dialogboksen farge som gjør det mulig for brukeren å velge en farge.

BOOL ChooseColor) LPCHOOSECOLOR  lpcc / / peker til struktur med initialisering / / data);
 

Parametere

lpcc
Pekeren til en CHOOSECOLOR struktur som inneholder informasjon som brukes til å initialisere dialogboksen. Når ChooseColor kommer tilbake, inneholder denne strukturen informasjon om brukerens fargevalget.

Returverdier

Hvis brukeren klikker OK i dialogboksen, er returverdien er ikke-null. RgbResult -medlem av CHOOSECOLOR -strukturen inneholder RGB-fargeverdi av fargen som er valgt av brukeren.

Hvis brukeren avbryter eller lukker dialogboksen farge , eller det oppstår en feil, er verdien som returneres Null. Vil ha utvidet feilinformasjon, kall funksjonen CommDlgExtendedError , som kan returnere en av følgende verdier:

CDERR_FINDRESFAILURE CDERR_MEMLOCKFAILURE
CDERR_INITIALIZATION CDERR_NOHINSTANCE
CDERR_LOCKRESFAILURE CDERR_NOHOOK
CDERR_LOADRESFAILURE CDERR_NOTEMPLATE
CDERR_LOADSTRFAILURE CDERR_STRUCTSIZE
CDERR_MEMALLOCFAILURE

Merknader

Dialogboksen farge støtter ikke palettene. Fargevalg som tilbys av dialogboksen er begrenset til systemfarger og rastrerte versjoner av disse fargene.

Du kan gi en CCHookProc hook-prosedyre for en farge -dialogboks. Bindingsprosedyren kan behandle meldinger som er sendt til dialogboksen. Hvis du vil aktivere en Bindingsprosedyren, sette CC_ENABLEHOOK-flagget i flagg -medlem av CHOOSECOLOR -strukturen og angir adressen til Bindingsprosedyren i lpfnHook -medlem.

Hurtiginformasjon

nbsp; Windows &NT: krever versjon 3.1 eller senere.
Windows:Krever Windows 95 eller senere.
Windows CE:Krever versjon 2.0 eller senere.
Topptekst:Deklarert i commdlg.h.
Importere biblioteket:Bruk comdlg32.lib.
Unicode:Implementert som Unicode- og ANSI-versjoner på Windows NT.

Se også

Felles biblioteket dialogboksoversikt, felles dialogboksen fungerer, CCHookProc, CHOOSECOLOR, CommDlgExtendedError

Index