CHOOSECOLOR

De CHOOSECOLOR structuur bevat de functie ChooseColor gebruikt voor het initialiseren van het dialoogvenster gemeenschappelijke kleur informatie. Nadat de gebruiker het dialoogvenster sluit, geeft het systeem informatie over de selectie van de gebruiker in deze structuur.

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

Leden

lStructSize

Hiermee geeft u de lengte, in bytes, van de structuur.

hwndOwner

Identificeert het venster dat eigenaar is van het dialoogvenster. Dit lid kan elk geldig vensteringang, of het kan worden NULL als het dialoogvenster geen eigenaar heeft.

hInstance

Als de vlag CC_ENABLETEMPLATEHANDLE is ingesteld in de vlaggen lid, is hInstance het handvat van een geheugen-object met een dialoogvenster vak sjabloon. Als de vlag CC_ENABLETEMPLATE is ingesteld, identificeert hInstance een module die een dialoogvenster vak sjabloon met de naam door de lpTemplateName lid bevat. Als noch CC_ENABLETEMPLATEHANDLE noch CC_ENABLETEMPLATE is ingesteld, wordt dit lid genegeerd.

rgbResult

Als de vlag CC_RGBINIT is ingesteld, geeft rgbResult de kleur in eerste instantie geselecteerd wanneer het dialoogvenster is gemaakt. Als de waarde van de opgegeven kleur niet onder de beschikbare kleuren is, selecteert het systeem de dichtstbijzijnde effen kleur beschikbaar. Als rgbResult gelijk is aan nul of CC_RGBINIT niet is ingesteld, is de aanvankelijk geselecteerde kleur zwart. Als de gebruiker op de knop OK klikt, geeft rgbResult kleurselectie van de gebruiker.

lpCustColors

Aanwijzer naar een matrix van 16 COLORREF waarden rood, groen en blauw (RGB)-waarden voor de aangepaste kleur met vakken in het dialoogvenster. Als de gebruiker deze kleuren wijzigt, werkt het systeem de matrix met de nieuwe RGB-waarden. Nieuwe aangepaste kleuren tussen aanroepen van de functie ChooseColor behouden, moet u statisch geheugen toewijzen voor de array.

Vlaggen

Een set van bits vlaggen die u gebruiken kunt voor het initialiseren van het dialoogvenster gemeenschappelijke kleur . Als u in het dialoogvenster als resultaat geeft, wordt deze vlaggen om aan te geven de invoer van de gebruiker. Dit lid kan bestaan uit een combinatie van de volgende vlaggen:

Vlag	Betekenis
CC_ANYCOLOR	Het dialoogvenster weer te geven van alle beschikbare kleuren in de set van basiskleuren veroorzaakt.
CC_ENABLEHOOK	Laat de haak-procedure van de lpfnHook lid van deze structuur. Deze vlag wordt alleen gebruikt om het dialoogvenster te initialiseren.
CC_ENABLETEMPLATE	Geeft aan dat de leden hInstance en lpTemplateName een dialoogvenster vak sjabloon om te gebruiken in plaats van de standaardsjabloon opgeven. Deze vlag wordt alleen gebruikt om het dialoogvenster te initialiseren.
CC_ENABLETEMPLATEHANDLE	Geeft aan dat de hInstance lid identificeert een gegevensblok dat een voorgeladen dialoogvenster vak sjabloon bevat. Het systeem negeert de lpTemplateName lid als deze vlag is opgegeven. Deze vlag wordt alleen gebruikt om het dialoogvenster te initialiseren.
CC_FULLOPEN	Zorgt ervoor dat het dialoogvenster om de extra besturingselementen waarmee de gebruiker om aangepaste kleuren te maken weer te geven. Als deze vlag niet is ingesteld, de gebruiker moet klikt u op deaangepasteknopkleur definiërende aangepaste kleur besturingselementen wilt weergeven .
CC_PREVENTFULLOPEN	Hiermee schakelt u de knop definiërenaangepastekleuren .
CC_RGBINIT	Het dialoogvenster gebruiken de kleur die is opgegeven in de rgbResult lid als de eerste kleurselectie wordt.
CC_SHOWHELP	Zorgt ervoor dat het dialoogvenster helpknop moet worden weergegeven. De hwndOwner lid moet opgeven het venster voor het ontvangen van de HELPMSGSTRING geregistreerd berichten die in het dialoogvenster worden verzonden wanneer de gebruiker op de knop Help.
CC_SOLIDCOLOR	Het dialoogvenster weer te geven alleen effen kleuren in de set van basiskleuren veroorzaakt.

lCustData

Hiermee geeft u de toepassing gedefinieerde gegevens het systeem doorgeeft aan de haak procedure geïdentificeerd door het lid lpfnHook . Wanneer het systeem het bericht WM_INITDIALOG naar de haak procedure verzendt, is van het bericht lParam parameter dat een aanwijzer naar de structuur CHOOSECOLOR opgegeven toen het dialoogvenster werd gemaakt. De haak procedure kunt deze aanwijzer gebruiken om de waarde van lCustData.

lpfnHook

Pointer naar een CCHookProc haak procedure die kan verwerken berichten die bestemd zijn voor het dialoogvenster. Dit lid wordt genegeerd, tenzij de CC_ENABLEHOOK vlag is ingesteld in de vlaggen lid.

lpTemplateName

Aanwijzer naar een op null eindigende tekenreeks that names de dialoogvenster vak sjabloon resource in de module geïdentificeerd door het lid hInstance . Deze sjabloon vervangen door de standaard dialoogvenster vak sjabloon. Voor genummerde dialoogvenster vak resources kunnen lpTemplateName een waarde die wordt geretourneerd door de macro MAKEINTRESOURCE . Dit lid wordt genegeerd, tenzij de CC_ENABLETEMPLATE vlag is ingesteld in de vlaggen lid.

Syntaxisinfo

nbsp; Windows &NT: versie 3.1 of hoger vereist.
Windows:Windows 95 of hoger vereist.
Windows CE:Versie 1.0 of hoger vereist.
Header:Verklaard in commdlg.h.
Unicode:Gedefinieerd als Unicode en ANSI structuren.

Zie ook

Overzicht van bibliotheek het gemeenschappelijk dialoogvenster, gemeenschappelijke dialoogvenster vak structuren, CCHookProc, ChooseColor, MAKEINTRESOURCE, WM_INITDIALOG