Gyakori vezérlőparaméterek

Az alábbiakban egy vezérlőerőforrás-definíciós utasítás általános szintaxisát mutatjuk be. Az egyes paraméterek jelentése alább látható. Előfordulhat, hogy egy utasítás másként használ egy paramétert, vagy figyelmen kívül hagy egy paramétert. Az utasítás-specifikus változatot az utasítás dokumentációja ismerteti.

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

szöveg

A vezérlőelemmel megjelenítendő szöveg. A szöveg a vezérlőn belül vagy a vezérlőelem mellett helyezkedik el.

Ennek a paraméternek nulla vagy több karaktert kell tartalmaznia dupla idézőjelek ("). A sztringek automatikusan null értékűek lesznek, és Unicode-ra konvertálódnak az eredményül kapott erőforrásfájlban.

Alapértelmezés szerint a kettős idézőjelek között felsorolt karakterek ANSI-karakterek, a menekülési sorozatok pedig bájtos feloldósorozatokként vannak értelmezve. Ha a sztringet az "L" előtag előzi meg, a sztring egy széles karakterből álló sztring, és a feloldósorozatok Unicode-karaktereket megjelölő két bájtos feloldósorozatként vannak értelmezve. Ha kettős idézőjelre van szükség a szövegben, kétszer kell megadnia a dupla idézőjelet.

A szöveg ampersand (&) karaktere azt jelzi, hogy a vezérlőelemhez a következő karaktert használja a rendszer. A vezérlő megjelenítésekor az erősítő nem jelenik meg, de a mnemonikus karakter alá van aláhúzva. A felhasználó az aláhúzott mnemon karakternek megfelelő kulccsal választhatja ki a vezérlőt. Ha karakterként szeretné használni az ampersand karaktert egy sztringben, szúrjon be két ampersands (&&).

azonosító

Vezérlőazonosító. Ennek az értéknek a 0 és 65 535 közötti tartományban egy 16 bites, aláíratlan egész számnak vagy egy egyszerű számtani kifejezésnek kell lennie, amely az adott tartományban lévő értékre értékel.

x

A vezérlő bal oldalának X koordinátája a párbeszédpanel bal oldalához viszonyítva. Ennek az értéknek 16 bites, aláíratlan egész számnak kell lennie a 0 és 65 535 közötti tartományban. A koordináta párbeszédpanel-egységekben található, és a megadott vezérlőt tartalmazó párbeszédpanel, ablak vagy vezérlőelem forrásához viszonyítva van.

y

A vezérlő felső oldalának Y koordinátája a párbeszédpanel tetejéhez viszonyítva. Ennek az értéknek 16 bites, aláíratlan egész számnak kell lennie a 0 és 65 535 közötti tartományban. A koordináta a megadott vezérlőt tartalmazó párbeszédpanel, ablak vagy vezérlőelem eredetéhez viszonyított párbeszédpanel-egységekben található.

szélesség

A vezérlő szélessége. Ennek az értéknek 16 bites, aláíratlan egész számnak kell lennie az 1 és 65 535 közötti tartományban. A szélesség 1/4 karakterből áll.

magasság

A vezérlő magassága. Ennek az értéknek 16 bites, aláíratlan egész számnak kell lennie az 1 és 65 535 közötti tartományban. A magasság 1/8 karakterből áll.

stílus

Vezérlőstílusok. A stílusok kombinálásához használja a bitenkénti OR (|) operátort. További információ: Ablakstílusok.

bővített stílusú

Bővített ablakstílusok. bővített stílusúmeg kell adnia stílus. További információ: EXSTYLE.

helpId

Numerikus kifejezés, amely a vezérlőelem WM_HELP feldolgozás során történő azonosításához használt azonosítót jelzi.

controlData

Vezérlőspecifikus adatok a vezérlőhöz. Amikor létrejön egy párbeszédpanel, és létrejön egy vezérlőspecifikus adatokat tartalmazó vezérlő a párbeszédpanelen, az adott adatokra mutató mutató kerül a vezérlő ablakának eljárásába az adott vezérlőelem WM_CREATE üzenetének lParam keresztül.

Megjegyzések

A vízszintes párbeszédpanel-egységek a párbeszédpanel alapszélesség-egységének 1/4-ét tartalmazzák. A függőleges egységek a párbeszédpanel alapmagasság-egységének 1/8-át tartalmazzák. Az aktuális párbeszédpanel alapegységei az aktuális rendszer betűtípusának magasságából és szélességéből vannak kiszámítva. A GetDialogBaseUnits függvény képpontban adja vissza a párbeszédpanel alapegységeit. A koordináták a párbeszédpanel eredetéhez viszonyítva jelennek meg.