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