Typowe parametry kontrolki

Poniżej opisano ogólną składnię instrukcji definicji zasobów kontroli. Poniżej podano znaczenie każdego parametru. Czasami instrukcja będzie używać parametru inaczej lub może zignorować parametr. Odmiana specyficzna dla instrukcji jest opisana w dokumentacji instrukcji .

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

tekst

Tekst, który ma być wyświetlany za pomocą kontrolki. Tekst jest umieszczony w kontrolce lub sąsiaduje z kontrolką.

Ten parametr musi zawierać zero lub więcej znaków ujętych w podwójny cudzysłów ("). Ciągi są automatycznie przerywane o wartości null i konwertowane na Unicode w wynikowym pliku zasobu.

Domyślnie znaki wymienione między podwójnym cudzysłowem są znakami ANSI, a sekwencje ucieczki są interpretowane jako sekwencje ucieczki bajtów. Jeśli ciąg jest poprzedzony prefiksem "L", ciąg jest ciągiem wieloznakowym, a sekwencje ucieczki są interpretowane jako 2-bajtowe sekwencje ucieczki, które określają znaki Unicode. Jeśli w tekście wymagany jest podwójny cudzysłów, należy dwukrotnie dołączyć podwójny cudzysłów.

Znak ampersand (&) w tekście wskazuje, że następujący znak jest używany jako znak mnemonic dla kontrolki. Gdy kontrolka jest wyświetlana, znak ampersand nie jest wyświetlany, ale znak mnemonic jest podkreślony. Użytkownik może wybrać kontrolkę, naciskając odpowiadający podkreślonemu znakowi mnemonic. Aby użyć znaku ampersand w ciągu, wstaw dwa znaki i (&&).

identyfikatora

Identyfikator kontrolki. Ta wartość musi być 16-bitową liczbą całkowitą bez znaku w zakresie od 0 do 65 535 lub prostym wyrażeniem arytmetycznym, które oblicza wartość w tym zakresie.

x

Współrzędna X lewej strony kontrolki względem lewej strony okna dialogowego. Ta wartość musi być 16-bitową liczbą całkowitą bez znaku w zakresie od 0 do 65 535. Współrzędna znajduje się w jednostkach dialogowych i jest względna względem źródła okna dialogowego, okna lub kontrolki zawierającej określoną kontrolkę.

y

Współrzędna Y górnej części kontrolki względem górnej części okna dialogowego. Ta wartość musi być 16-bitową liczbą całkowitą bez znaku w zakresie od 0 do 65 535. Współrzędna znajduje się w jednostkach dialogowych względem źródła okna dialogowego, okna lub kontrolki zawierającej określoną kontrolkę.

szerokość

Szerokość kontrolki. Ta wartość musi być 16-bitową liczbą całkowitą bez znaku w zakresie od 1 do 65 535. Szerokość jest wyrażona w jednostkach 1/4 znaków.

wysokości

Wysokość kontrolki. Ta wartość musi być 16-bitową liczbą całkowitą bez znaku w zakresie od 1 do 65 535. Wysokość jest wyrażona w jednostkach 1/8 znaków.

stylu

Style kontrolek. Użyj operatora bitowego OR (|), aby połączyć style. Aby uzyskać więcej informacji, zobacz Style okien.

w stylu rozszerzonym

Rozszerzone style okien. Należy określić styl, aby określić stylu rozszerzonego. Aby uzyskać więcej informacji, zobacz EXSTYLE.

helpId

Wyrażenie liczbowe wskazujące identyfikator używany do identyfikowania kontrolki podczas przetwarzania WM_HELP.

controlData

Dane specyficzne dla kontrolki. Po utworzeniu okna dialogowego i utworzeniu kontrolki w tym oknie dialogowym, w którym są tworzone dane specyficzne dla kontrolki, wskaźnik do tej kontrolki jest przekazywany do procedury okna kontrolki za pośrednictwem lParam komunikatu WM_CREATE dla tej kontrolki.

Uwagi

Jednostki okien dialogowych poziomych to 1/4 jednostki szerokości bazowej okna dialogowego. Jednostki pionowe to 1/8 jednostki wysokości bazowej okna dialogowego. Bieżące jednostki bazowe okna dialogowego są obliczane z wysokości i szerokości bieżącej czcionki systemowej. Funkcja GetDialogBaseUnits zwraca jednostki podstawowe okna dialogowego w pikselach. Współrzędne są względne względem źródła okna dialogowego.