ChooseColor

De functie ChooseColor maakt een kleur common dialog box waarmee de gebruiker om een kleur te selecteren.

() BOOL ChooseColor LPCHOOSECOLOR  lpcc / / aanwijzer structuur met initialisatie / / gegevens);
 

Parameters

lpcc
Aanwijzer naar een CHOOSECOLOR structuur waarin de gegevens gebruikt voor het initialiseren van het dialoogvenster. Als ChooseColor resultaat geeft, bevat deze structuur informatie over kleurselectie van de gebruiker.

Retourwaarden

Als de gebruiker op de knop OK in het dialoogvenster, is de geretourneerde waarde dan nul. De rgbResult lid van de CHOOSECOLOR structuur bevat de RGB-waarde van de kleur die is geselecteerd door de gebruiker.

Als de gebruiker annuleert of sluit u het dialoogvenster kleur of een fout optreedt, is de retourwaarde nul. Om uitgebreide foutinformatie, roept de functie CommDlgExtendedError , die in één van de volgende waarden resulteren kan:

CDERR_FINDRESFAILURE CDERR_MEMLOCKFAILURE
CDERR_INITIALIZATION CDERR_NOHINSTANCE
CDERR_LOCKRESFAILURE CDERR_NOHOOK
CDERR_LOADRESFAILURE CDERR_NOTEMPLATE
CDERR_LOADSTRFAILURE CDERR_STRUCTSIZE
CDERR_MEMALLOCFAILURE

Opmerkingen

Het dialoogvenster kleur biedt geen ondersteuning voor paletten. De opties in het dialoogvenster kleur zijn beperkt tot de systeemkleuren en gerasterde versies van die kleuren.

U kunt een CCHookProc haak procedure voorzien in het dialoogvenster kleur . De haak procedure kan verwerken berichten die worden verzonden naar het dialoogvenster. Om een haak procedure, in het lid van de vlaggen van de CHOOSECOLOR structuur de CC_ENABLEHOOK vlag instellen en opgeven van het adres van de haak-procedure in de lpfnHook lid.

Syntaxisinfo

nbsp; Windows &NT: versie 3.1 of hoger vereist.
Windows:Windows 95 of hoger vereist.
Windows CE:Versie 2.0 of hoger vereist.
Header:Verklaard in commdlg.h.
Bibliotheek importeren:Gebruik comdlg32.lib.
Unicode:Geïmplementeerd als Unicode en ANSI-versies van Windows NT.

Zie ook

Overzicht van bibliotheek het gemeenschappelijk dialoogvenster, gemeenschappelijk dialoogvenster vak functies, CCHookProc, CHOOSECOLOR, CommDlgExtendedError

Index