Běžné parametry ovládacího prvku

Následující článek popisuje obecnou syntaxi příkazu control resource-definition. Význam každého parametru je uveden níže. Někdy příkaz použije parametr jinak nebo může parametr ignorovat. Varianta specifická pro příkaz je popsaná v dokumentaci k příkazu.

control [[text,]] id, x, y, width, height[[, style[[, extended-style]]]][, helpId]
[{ data-element-1 [, data-element-2 [,  . . . ]]}]

textové

Text, který se má zobrazit pomocí ovládacího prvku Text se umístí do ovládacího prvku nebo vedle ovládacího prvku.

Tento parametr musí obsahovat nula nebo více znaků uzavřených v uvozovkách ("). Řetězce se ve výsledném souboru prostředků automaticky ukončují a převedou na Unicode.

Ve výchozím nastavení jsou znaky uvedené mezi dvojitými uvozovkami znaky ANSI a řídicí sekvence se interpretují jako řídicí sekvence bajtů. Pokud před řetězcem předchází předpona "L", řetězec je řetězec širokým znakem a řídicí sekvence jsou interpretovány jako 2 bajtové řídicí sekvence, které určují znaky Unicode. Pokud je v textu vyžadována dvojitá uvozovka, musíte dvojitou uvozovku zahrnout dvakrát.

Znak ampersand (&) v textu označuje, že následující znak se pro ovládací prvek používá jako mnemónní znak. Při zobrazení ovládacího prvku se ampersand nezobrazí, ale měmónní znak je podtržený. Uživatel může ovládací prvek zvolit stisknutím klávesy odpovídající podtrženému měmónnímu znaku. Pokud chcete ampersand použít jako znak v řetězci, vložte dva ampersandy (&&).

id

Identifikátor ovládacího prvku. Tato hodnota musí být 16bitové celé číslo bez znaménka v rozsahu 0 až 65 535 nebo jednoduchý aritmetický výraz, který se vyhodnotí jako hodnota v dané oblasti.

x

Souřadnice X levé strany ovládacího prvku vzhledem k levé straně dialogového okna. Tato hodnota musí být 16bitové celé číslo bez znaménka v rozsahu 0 až 65 535. Souřadnice je v jednotkách dialogového okna a je relativní vzhledem k počátku dialogového okna, okna nebo ovládacího prvku obsahujícího zadaný ovládací prvek.

y

Souřadnice Y horní strany ovládacího prvku vzhledem k horní části dialogového okna. Tato hodnota musí být 16bitové celé číslo bez znaménka v rozsahu 0 až 65 535. Souřadnice je v jednotkách dialogového okna vzhledem k počátku dialogového okna, okna nebo ovládacího prvku obsahujícího zadaný ovládací prvek.

šířka

Šířka ovládacího prvku Tato hodnota musí být 16bitové celé číslo bez znaménka v rozsahu 1 až 65 535. Šířka je v jednotkách 1/4 znaků.

výšky

Výška ovládacího prvku. Tato hodnota musí být 16bitové celé číslo bez znaménka v rozsahu 1 až 65 535. Výška je v jednotkách 1/8 znaků.

stylu

Styly ovládacích prvků Ke kombinování stylů použijte bitový operátor OR (|). Další informace naleznete v tématu Styly oken.

rozšířeného stylu

Rozšířené styly oken. Chcete-li zadat rozšířeného stylu, je nutné zadat stylu . Další informace naleznete v EXSTYLE.

id nápovědy

Číselný výraz označující ID použité k identifikaci ovládacího prvku během zpracování WM_HELP.

controlData

Data specifická pro ovládací prvek. Při vytvoření dialogového okna a ovládací prvek v dialogovém okně, který obsahuje data specifická pro ovládací prvek, se ukazatel na tato data předá do okna ovládacího prvku prostřednictvím lParam zprávy WM_CREATE pro daný ovládací prvek.

Poznámky

Vodorovné jednotky dialogového okna jsou 1/4 jednotky základní šířky dialogového okna. Svislé jednotky jsou 1/8 jednotky základní výšky dialogového okna. Základní jednotky aktuálního dialogového okna se počítají z výšky a šířky aktuálního systémového písma. Funkce GetDialogBaseUnits vrátí základní jednotky dialogového okna v pixelech. Souřadnice jsou relativní vzhledem k počátku dialogového okna.