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
• Functions
• maker
• zprávy
• oznámení
• struktury
• konstanty

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ů.

Functions

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ů.