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