CHOOSECOLOR

CHOOSECOLOR štruktúra obsahuje informácie ChooseColor funkcia používa na inicializáciu dialógovom okne Farba spoločné. Po používateľ zavrie dialógové okno, sa systém vráti informácie o používateľovi výber v tejto štruktúre.

tYPEDEF struct {/ / kópia DWORD lStructSize; 
    HWND hwndOwner; 
    HWND hInstance; 
    COLORREF rgbResult; 
    COLORREF * lpCustColors; 
    DWORD Vlajky; 
    LPARAM lCustData; 
    LPCCHOOKPROC lpfnHook; 
    LPCTSTR lpTemplateName; 
} CHOOSECOLOR 
 

Členovia

lStructSize
Určuje dĺžku v bajtoch konštrukcie.
hwndOwner
Identifikuje okna, že vlastní dialógového okna. Tento člen môže byť akékoľvek platné okno rukoväť, alebo môže mať hodnotu NULL, ak dialógovom okne žiadne vlastníka.
hInstance
Ak v členských štátoch vlajky je nastavený príznak CC_ENABLETEMPLATEHANDLE, hInstance je rukoväť pamäte objekt obsahujúci šablónu dialógové okno pole. Ak je nastavený príznak CC_ENABLETEMPLATE hInstance identifikuje modul, ktorý obsahuje dialógové okno pole šablónu s názvom členskými lpTemplateName . Ak je nastavený CC_ENABLETEMPLATEHANDLE ani CC_ENABLETEMPLATE, tento člen sa ignoruje.
rgbResult
Ak je nastavený príznak CC_RGBINIT rgbResult určuje farbu pôvodne vybraným novovytvorený dialógového okna. Ak sa hodnota zadaného farba nie je medzi dostupných farieb, systém vyberie a zobrazí dostupné najbližší jednofarebné. Ak rgbResult je nula alebo CC_RGBINIT nie je nastavený, pôvodne vybratých farieb je čierna. Ak používateľ klikne na tlačidlo OK, rgbResult určuje výber farieb používateľa.
lpCustColors
Ukazovateľ na pole hodnôt 16 COLORREF, ktoré obsahujú hodnoty červenej, zelenej a modrej (RGB) na vlastnú farbu políčok v dialógovom okne. Ak používateľ zmení tieto farby, systém aktualizuje pole nových hodnôt RGB. Chcete zachovať nové vlastné farby medzi hovormi na ChooseColor funkciu, by mali prideliť statická pamäť pre pole.
Príznaky
Množina bitové príznaky, ktoré môžete použiť pri inicializácii dialógovom okne Farba spoločné. Keď dialógovom okne vráti, stanovuje tieto príznaky označovať vstup používateľa. Tento člen môže byť kombináciou nasledovné príznaky:
Vlajka Význam
CC_ANYCOLOR Spôsobuje zobrazovať dialógové okno na zobrazenie všetkých dostupných farieb v množine základné farby.
CC_ENABLEHOOK Umožňuje háku postupom špecifikovaným v lpfnHook člen tejto štruktúry. Tento príznak sa používa len na inicializáciu dialógového okna.
CC_ENABLETEMPLATE Označuje, že členovia hInstance a lpTemplateName bližšie určiť šablónu dialógové okno políčka použiť na mieste predvolenú šablónu. Tento príznak sa používa len na inicializáciu dialógového okna.
CC_ENABLETEMPLATEHANDLE Označuje členský hInstance identifikuje dátový blok obsahuje šablóny předpjatý dialógové okno pole. Systému ignoruje členských lpTemplateName , ak táto vlajka je určený. Tento príznak sa používa len na inicializáciu dialógového okna.
CC_FULLOPEN Spôsobuje dialógovom okne zobraziť ďalšie ovládacie prvky, ktoré umožňujú používateľovi vytvárať vlastné farby. Ak nie je nastavená táto vlajka, používateľ musí kliknite na položku definovať vlastné farby tlačidlo zobraziť vlastnú farbu ovládacích prvkov.
CC_PREVENTFULLOPEN Vypína tlačidlo definovaťvlastnéfarby .
CC_RGBINIT Spôsobuje dialógovom okne použiť farby zadané v členských rgbResult ako výber počiatočného farieb.
CC_SHOWHELP Spôsobuje dialógovom okne zobraziť na tlačidlo Pomocník. HwndOwner člen musí špecifikovať okno prijímať HELPMSGSTRING registrované správy, že keď používateľ klikne na tlačidlo Pomocník sa pošle dialógového okna.
CC_SOLIDCOLOR Spôsobuje dialógovom okne zobraziť iba plnými farbami v množine základné farby.

lCustData
Určuje definovanom aplikáciou údaje, ktoré systém odovzdá príslušná procedúra identifikované členskými lpfnHook . Keď systém odošle hlásenie WM_INITDIALOG príslušná procedúra, správu lParam parameter je smerník na štruktúru CHOOSECOLOR uvedené, kedy bol vytvorený dialógového okna. Príslušná procedúra môžete použiť tento ukazovateľ na získanie hodnoty lCustData.
lpfnHook
Smerník na CCHookProc háku postup, ktorý môže spracovávať správy určené pre dialógového okna. Tento člen sa ignoruje, pokiaľ nie je v členských štátoch vlajky je nastavený príznak CC_ENABLEHOOK.
lpTemplateName
Ukazovateľ na reťazec zakončený, že názvy dialógové okno pole Šablóna zdrojov v module identifikované členskými hInstance . Táto šablóna je nahradená štandardné dialógové okno pole Šablóna. Pre číslované dialógové okno pole zdroje, lpTemplateName môže byť hodnota odoslal MAKEINTRESOURCE makro. Tento člen sa ignoruje, pokiaľ nie je v členských štátoch vlajky je nastavený príznak CC_ENABLETEMPLATE.

Stručné informácie

nbsp; Systém Windows &NT: vyžaduje verzia 3.1 alebo novšia.
Windows:Vyžaduje systém Windows 95 alebo novším.
Windows CE:Vyžaduje verziu 1.0 alebo novšiu verziu.
Hlavičky:Deklarovaný v commdlg.h.
Unicode:Definovaný formát Unicode a ANSI štruktúry.

Pozri tiež

Spoločné Prehľad dialógového okna Knižnica, spoločné Dialog Box štruktúry, CCHookProc, ChooseColor, MAKEINTRESOURCE, WM_INITDIALOG