Obecné referenční informace k ovládacím prvkům
Tato část obsahuje referenční informace o programovacíchprvch Většina ovládacích prvků podporuje funkce, makra, zprávy, oznámení a struktury. Většina ovládacích prvků například používá oznámení NM_HOVER ke zpracování kliknutí myší.
Přehledy
| Námět | Obsah |
|---|---|
| o běžných ovládacích prvcích | Běžné ovládací prvky jsou sada oken, která jsou implementována společnou knihovnou ovládacích prvků, což je knihovna DLL součástí operačního systému Windows. |
| Nejčastější dotazy k běžných ovládacích prvků | V těchto nejčastějších dotazech najdete odpovědi na některé běžné otázky týkající se běžných ovládacích prvků. |
Funkce
| Námět | Obsah |
|---|---|
| DoReaderMode | Povolí režim čtečky v okně. |
| DPA_Clone | Duplikuje pole dynamického ukazatele (DPA). |
| DPA_Create | Vytvoří DPA. |
| DPA_CreateEx | Vytvoří DPA pomocí zadané velikosti a umístění haldy. |
| DPA_DeleteAllPtrs | Odebere všechny položky z DPA a odpovídajícím způsobem zmenší DPA. |
| DPA_DeletePtr | Odebere položku z DPA. DpA se v případě potřeby zmenší tak, aby vyhovovala odebrané položce. |
| DPA_Destroy | Uvolní pole dynamických ukazatelů (DPA). |
| DPA_DestroyCallback | Volání pfnCB na každém prvku DPA a pak uvolní DPA. |
| DPA_EnumCallback | Iteruje prostřednictvím pole dynamického ukazatele (DPA) a volá pfnCB pro každou položku. |
| DPA_GetPtr | Získá položku z DPA. |
| DPA_GetPtrIndex | Získá index odpovídající položky nalezené v DPA. |
| DPA_GetSize | Získá velikost DPA. |
| DPA_Grow | Změní počet ukazatelů v DPA. |
| DPA_InsertPtr | Vloží novou položku na zadanou pozici v DPA. V případě potřeby se DPA rozbalí tak, aby vyhovovala nové položce. |
| DPA_LoadStream | Načte DPA z datového proudu voláním zadané funkce zpětného volání ke čtení jednotlivých prvků. |
| DPA_Merge | Kombinuje obsah dvou DPA. |
| DPA_SaveStream | Uloží DPA do datového proudu tím, že zapíše hlavičku a potom zavolá zadanou funkci zpětného volání pro zápis každého prvku. |
| DPA_Search | Najde položku v DPA. |
| DPA_SetPtr | Přiřadí hodnotu k položce v DPA. |
| DPA_Sort | Seřadí položky v poli dynamického ukazatele (DPA). |
| drawShadowText | Nakreslí text, který má stín. |
| DrawTextExPrivWrap | Nakreslí formátovaný text v zadaném obdélníku. Tato funkce zabalí volání DrawTextEx. |
| DrawTextWrap | Nakreslí formátovaný text v zadaném obdélníku. Formátuje text podle zadané metody (rozbalení tabulátorů, zarovnání znaků, zalomení čar atd.). Tato funkce zabalí volání DrawText. |
| DSA_Clone | Duplikuje pole dynamické struktury (DSA). |
| DSA_Create | Vytvoří DSA. |
| DSA_DeleteAllItems | Odstraní všechny položky z DSA. |
| DSA_DeleteItem | Odstraní položku z DSA. |
| DSA_Destroy | Uvolní DSA. |
| DSA_DestroyCallback | Iteruje prostřednictvím DSA a volá zadanou funkci zpětného volání pro každou položku. Po dosažení konce pole se dsA uvolní. |
| DSA_EnumCallback | Iteruje prostřednictvím DSA a volá pfnCB pro každou položku. |
| DSA_GetItem | Získá prvek z DSA. |
| DSA_GetItemPtr | Získá ukazatel na prvek z DSA. |
| DSA_GetSize | Získá velikost DSA. |
| DSA_InsertItem | Vloží novou položku do DSA. V případě potřeby se DSA rozbalí tak, aby vyhovovala nové položce. |
| DSA_SetItem | Nastaví obsah elementu v DSA. |
| DSA_Sort | Seřadí položky v dsA. |
| ExtTextOutWrap | Nakreslí text pomocí aktuálně vybraného písma, barvy pozadí a barvy textu. Volitelně můžete zadat rozměry, které se mají použít pro oříznutí, neprůhlednost nebo obojí. Tato funkce zabalí volání ExtTextOut. |
| GetEffectiveClientRect | Vypočítá rozměry obdélníku v klientské oblasti, která obsahuje všechny zadané ovládací prvky. |
| getMUILanguage | Získá jazyk, který se aktuálně používá běžnými ovládacími prvky pro konkrétní proces. |
| GetTextExtentPoint32Wrap | Vypočítá šířku a výšku zadaného řetězce textu. Tato funkce zabalí volání GetTextExtentPoint. |
| InitCommonControls | Zaregistruje a inicializuje určité běžné třídy ovládacích oken. Tato funkce je zastaralá. Nové aplikace by měly používat funkci InitCommonControlsEx. |
| InitCommonControlsEx | Zaregistruje konkrétní běžné třídy ovládacích prvků z knihovny DLL běžných ovládacích prvků. |
| InitMUILanguage | Umožňuje aplikaci určit jazyk, který se má použít s běžnými ovládacími prvky, které se liší od systémového jazyka. |
| LoadIconMetric | Načte zadaný prostředek ikony s metrikou systému určenou klientem. |
| LoadIconWithScaleDown | Načte ikonu. Pokud ikona není standardní velikostí, tato funkce zmenší větší obrázek místo vertikálního navýšení kapacity menšího obrázku. |
| MirrorIcon | Obrácené ikony (zrcadlení) tak, aby se správně zobrazovaly v kontextu zrcadlených zařízení. |
| PFNDACOMPARE | Definuje prototyp funkce porovnání používané DSA_Sort. |
| PFNDACOMPARECONST | Definuje prototyp funkce porovnání používané DSA_Sort při porovnávání položek konstantními objekty. |
| PFNDAENUMCALLBACK | Definuje prototyp funkce zpětného volání používané funkcemi DSA a DPA. |
| PFNDAENUMCALLBACKCONST | Definuje prototyp funkce zpětného volání používané funkcemi DSA a DPA, pokud jsou zahrnuté položky ukazateli na konstantní data. |
| PFNDPACOMPARE | Definuje prototyp funkce porovnání používané DPA_Sort a DPA_Search. |
| PFNDPACOMPARECONST | Definuje prototyp funkce porovnání používané DPA_Sort nebo DPA_Search při porovnávání položek konstantními objekty. |
| PFNDPAENUMCALLBACK | Definuje prototyp funkce zpětného volání, kterou používá DPA_EnumCallback. |
| PFNDPAMERGE | Definuje prototyp funkce sloučení používané DPA_Merge. |
| PFNDPAMERGECONST | Definuje prototyp funkce sloučení používané DPA_Mergepomocí konstantních hodnot. |
| PFNDPASTREAM | Definuje prototyp funkce zpětného volání používané DPA_LoadStream a DPA_SaveStream. |
| PFNDSAENUMCALLBACK | Definuje prototyp funkce zpětného volání, kterou používá DSA_DestroyCallback. |
| ReaderScroll | Funkce zpětného volání definovaná aplikací, která se používá při přesunutí ukazatele myši v části okna režimu čtečky deklarované jako aktivní oblast posouvání. |
| ShowHideMenuCtl | Nastaví nebo odebere atribut zaškrtnutí zadané položky nabídky a zobrazí nebo skryje odpovídající ovládací prvek. Funkce přidá značku zaškrtnutí k zadané položce nabídky, pokud ji nemá, a zobrazí odpovídající ovládací prvek. Pokud položka nabídky již obsahuje značku zaškrtnutí, funkce odebere značku zaškrtnutí a skryje odpovídající ovládací prvek. |
| Str_GetPtr | Zkopíruje řetězec z jedné vyrovnávací paměti do druhé. |
| Str_SetPtrW | Nastaví ppszCurrent na kopii pszNew a v případě potřeby uvolní předchozí hodnotu. |
| TranslateDispatch | Používá se klientem DoReaderMode funkce k zachycení a explicitnímu zpracování všech zpráv oken určených pro oblast posouvání okna režimu čtečky. Jedná se o funkci zpětného volání definovanou aplikací. |
Makra
| Námět | Obsah |
|---|---|
| DPA_AppendPtr | Vloží novou položku na konec DPA. |
| DPA_FastDeleteLastPtr | Odstraní poslední ukazatel z DPA. |
| DPA_FastGetPtr | Získá hodnotu zadaného ukazatele v DPA. |
| DPA_GetPtrCount | Získá počet ukazatelů v DPA. |
| DPA_GetPtrPtr | Získá ukazatel na interní pole ukazatele DPA. |
| DPA_SetPtrCount | Nastaví počet ukazatelů v DPA. |
| DPA_SortedInsertPtr | Vloží novou položku před nebo za zadanou existující položku. |
| DSA_AppendItem | Připojí novou položku na konec DSA. |
| DSA_GetItemCount | Získá počet položek v DSA. |
| FORWARD_WM_NOTIFY | Odešle nebo publikuje zprávu WM_NOTIFY. |
| HANDLE_WM_NOTIFY | Volá funkci, která zpracovává WM_NOTIFY zprávu. |
| INDEXTOSTATEIMAGEMASK | Připraví index obrázku stavu tak, aby ovládací prvek stromového zobrazení nebo ovládací prvek zobrazení seznamu mohl pomocí indexu načíst obrázek stavu pro položku. |
Zprávy
| Námět | Obsah |
|---|---|
| CCM_DPISCALE | Umožňuje automatické škálování velkých bodů na palec (dpi) v ovládacích prvcích Tree-View, ovládací prvky List-View, Ovládací prvky ComboBoxEx, ovládací prvky záhlaví, tlačítka, ovládací prvky panelu nástrojů, ovládací prvky animacea seznamy obrázků. |
| CCM_GETUNICODEFORMAT | Získá příznak formátu znaku Unicode pro ovládací prvek. |
| CCM_GETVERSION | Získá číslo verze ovládacího prvku nastaveného poslední CCM_SETVERSION zprávou. |
| CCM_SETUNICODEFORMAT | Nastaví příznak formátu znaku Unicode pro ovládací prvek. Tato zpráva umožňuje změnit znakovou sadu používanou ovládacím prvku za běhu, a nemusíte ho znovu vytvářet. |
| CCM_SETVERSION | Tato zpráva slouží k informování ovládacího prvku, že očekáváte chování spojené s konkrétní verzí. |
| CCM_SETWINDOWTHEME | Nastaví vizuální styl ovládacího prvku. |
| WM_NOTIFY | Odešle se běžným ovládacím prvek do nadřazeného okna, když došlo k události nebo ovládací prvek vyžaduje určité informace. |
| WM_NOTIFYFORMAT | Určuje, jestli okno přijímá struktury ANSI nebo Unicode ve zprávě s oznámením WM_NOTIFY.
WM_NOTIFYFORMAT zprávy se odesílají z běžného ovládacího prvku do nadřazeného okna a z nadřazeného okna do společného ovládacího prvku. |
Upozornění
| Námět | Obsah |
|---|---|
| NM_CHAR | Kód oznámení NM_CHAR odešle ovládací prvek při zpracování klíče znaku. Tento kód oznámení se odešle ve formě WM_NOTIFY zprávy. |
| NM_CUSTOMDRAW | Upozorní nadřazené okno ovládacího prvku o vlastních operacích kreslení. Tento kód oznámení se odešle ve formě WM_NOTIFY zprávy. |
| NM_CUSTOMTEXT | Upozorní nadřazené okno ovládacího prvku na vlastní textové operace. Tento kód oznámení se odešle ve formě WM_NOTIFY zprávy. |
| NM_FONTCHANGED | Odeslal ovládací prvek zobrazení seznamu, když ovládací prvek změnil písmo. Tento kód oznámení se odešle ve formě WM_NOTIFY zprávy. |
| NM_GETCUSTOMSPLITRECT | Posílaný ovládacím tlačítkem do nadřazeného ovládacího prvku, aby získal měření pro dva obdélníky, které tvoří rozdělené tlačítko. Tento kód oznámení se odešle ve formě WM_NOTIFY zprávy. |
| NM_HOVER | Odesílá se ovládacím prvku, když ukazatel myši najede na položku. Tento kód oznámení se odešle ve formě WM_NOTIFY zprávy. |
| NM_KEYDOWN | Odešle ovládací prvek, když má ovládací prvek fokus klávesnice a uživatel stiskne klávesu. Tento kód oznámení se odešle ve formě WM_NOTIFY zprávy. |
| NM_KILLFOCUS | Upozorní nadřazené okno ovládacího prvku, že ovládací prvek ztratil vstupní fokus. Tento kód oznámení se odešle ve formě WM_NOTIFY zprávy. |
| NM_LDOWN | Upozorní nadřazené okno ovládacího prvku, že bylo stisknuto levé tlačítko myši. Tento kód oznámení se odešle ve formě WM_NOTIFY zprávy. |
| NM_NCHITTEST | Odesláno ovládacím prvku panelu, když ovládací prvek obdrží WM_NCHITTEST zprávu. Tento kód oznámení se odešle ve formě WM_NOTIFY zprávy. |
| NM_OUTOFMEMORY | Upozorní nadřazené okno ovládacího prvku, že ovládací prvek nemohl dokončit operaci, protože nebylo k dispozici dostatek paměti. Tento kód oznámení se odešle ve formě WM_NOTIFY zprávy. |
| NM_RDOWN | Aktuálně se nepodporuje. |
| NM_RELEASEDCAPTURE | Upozorní nadřazené okno ovládacího prvku, že ovládací prvek uvolní zachycení myši. Tento kód oznámení se odešle ve formě WM_NOTIFY zprávy. |
| NM_RETURN | Upozorní nadřazené okno ovládacího prvku, že ovládací prvek má vstupní fokus a že uživatel stiskl klávesu ENTER. Tento kód oznámení se odešle ve formě WM_NOTIFY zprávy. |
| NM_SETCURSOR | Upozorní nadřazené okno ovládacího prvku, že ovládací prvek nastavuje kurzor v reakci na zprávu NM_SETCURSOR. Tento kód oznámení se odešle ve formě WM_NOTIFY zprávy. |
| NM_SETFOCUS | Upozorní nadřazené okno ovládacího prvku, že ovládací prvek obdržel vstupní fokus. Tento kód oznámení se odešle ve formě WM_NOTIFY zprávy. |
| NM_THEMECHANGED | Upozorní nadřazené okno ovládacího prvku, že se motiv změnil. Tento kód oznámení se odešle ve formě WM_NOTIFY zprávy. |
| NM_TOOLTIPSCREATED | Upozorní nadřazené okno ovládacího prvku, že ovládací prvek vytvořil ovládací prvek popisku. Tento kód oznámení se odešle ve formě WM_NOTIFY zprávy. |
| NM_TVSTATEIMAGECHANGING | Odesláno ovládacím prvkem stromového zobrazení do nadřazeného okna, které obrázek stavu mění. Tento kód oznámení se odešle ve formě WM_NOTIFY zprávy. |
Struktury
| Námět | Obsah |
|---|---|
| COLORSCHEME | Obsahuje informace o kreslení tlačítek na panelu nástrojů nebo na panelu nástrojů. |
| DPASTREAMINFO | Obsahuje položku datového proudu používanou funkcí PFNDPASTREAM zpětného volání. |
| INITCOMMONCONTROLSEX | Přenáší informace používané k načtení běžných řídicích tříd z dynamické knihovny (DLL). Tato struktura se používá s InitCommonControlsEx funkce. |
| NMCHAR | Obsahuje informace používané se zprávami s oznámením znaků. |
| NMCUSTOMSPLITRECTINFO | Obsahuje informace o dvou obdélníkech rozděleného tlačítka. Odesláno s oznámením NM_GETCUSTOMSPLITRECT. |
| NMCUSTOMTEXT | Obsahuje informace používané s vlastním textovým oznámením. |
| NMHDR | Obsahuje informace o zprávě s oznámením. |
| NMKEY | Obsahuje informace používané se zprávami s klíčovými oznámeními. |
| NMMOUSE | Obsahuje informace používané se zprávami s oznámeními myši. |
| NMOBJECTNOTIFY | Obsahuje informace používané s kódy oznámení TBN_GETOBJECT, TCN_GETOBJECTa PSN_GETOBJECT. |
| NMTOOLTIPSCREATED | Obsahuje informace používané s kódem oznámení NM_TOOLTIPSCREATED. |
| READERMODEINFO | Obsahuje informace potřebné k inicializaci funkce DoReaderMode. |
Konstanty
| Námět | Obsah |
|---|---|
| konstant CDRF | Tyto konstanty se používají jako návratové hodnoty ovládacím prvku v reakci na kód oznámení NM_CUSTOMDRAW. |
| styly | V této části jsou uvedeny běžné styly ovládacích prvků. Kromě toho, kde je uvedeno, se tyto styly vztahují na ovládací prvky záhlaví, ovládací prvky panelu nástrojů a stavová okna. |
| třídy oken | Tato část obsahuje seznam názvů tříd oken poskytovaných knihovnou běžných ovládacích prvků. |