Vanliga kontrollparametrar

Följande beskriver den allmänna syntaxen för en instruktion för kontrollresursdefinition. Innebörden av varje parameter anges nedan. Ibland använder en -instruktion en parameter på ett annat sätt eller ignorerar en parameter. Den instruktionsspecifika varianten beskrivs i dokumentationen för -instruktionen.

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

text

Text som ska visas med kontrollen. Texten placeras i kontrollen eller intill kontrollen.

Den här parametern måste innehålla noll eller fler tecken inom dubbla citattecken ("). Strängar avslutas automatiskt null och konverteras till Unicode i den resulterande resursfilen.

Som standard är de tecken som anges mellan de dubbla citattecknen ANSI-tecken och escape-sekvenser tolkas som byte-escape-sekvenser. Om strängen föregås av prefixet "L" är strängen en sträng med brett tecken och escape-sekvenser tolkas som 2 bytes escape-sekvenser som anger Unicode-tecken. Om ett dubbelt citattecken krävs i texten måste du inkludera det dubbla citattecknet två gånger.

Ett et-tecken (&) i texten anger att följande tecken används som ett mnemonic-tecken för kontrollen. När kontrollen visas visas inte et-tecknet, men mnemonic-tecknet är understruket. Användaren kan välja kontrollen genom att trycka på den nyckel som motsvarar det understrukna mnemonic-tecknet. Om du vill använda et-tecknet som ett tecken i en sträng infogar du två et-tecken (&&).

ID

Kontrollidentifierare. Det här värdet måste vara ett 16-bitars osignerat heltal i intervallet 0 till 65 535 eller ett enkelt aritmetiskt uttryck som utvärderas till ett värde i det intervallet.

x

X-koordinat för den vänstra sidan av kontrollen i förhållande till vänster i dialogrutan. Det här värdet måste vara ett 16-bitars osignerat heltal i intervallet 0 till 65 535. Koordinaten finns i dialogenheter och är relativ till ursprunget för dialogrutan, fönstret eller kontrollen som innehåller den angivna kontrollen.

y

Y-koordinat för kontrollens övre sida i förhållande till toppen av dialogrutan. Det här värdet måste vara ett 16-bitars osignerat heltal i intervallet 0 till 65 535. Koordinaten finns i dialogenheter i förhållande till ursprunget för dialogrutan, fönstret eller kontrollen som innehåller den angivna kontrollen.

bredd

Kontrollens bredd. Det här värdet måste vara ett 16-bitars osignerat heltal i intervallet 1 till 65 535. Bredden är i enheter med 1/4 tecken.

höjd

Kontrollens höjd. Det här värdet måste vara ett 16-bitars osignerat heltal i intervallet 1 till 65 535. Höjden är i enheter med 1/8 tecken.

formatmall

Kontrollformat. Använd operatorn BITVIS OR (|) för att kombinera formatmallar. Mer information finns i fönsterformat.

Utökade fönsterformat. Du måste ange formatmall för att ange utökad. Mer information finns i EXSTYLE.

helpId

Numeriskt uttryck som anger det ID som används för att identifiera kontrollen under WM_HELP bearbetning.

controlData

Kontrollspecifika data för kontrollen. När en dialogruta skapas och en kontroll i dialogrutan som har kontrollspecifika data skapas skickas en pekare till dessa data till kontrollens fönsterprocedur via lParam- av WM_CREATE meddelande för kontrollen.

Anmärkningar

Vågräta dialogrutor är 1/4 i dialogrutans basbreddsenhet. Lodräta enheter är 1/8 av dialogrutans bashöjdenhet. De aktuella dialogbasenheterna beräknas från höjden och bredden på det aktuella systemteckensnittet. Funktionen GetDialogBaseUnits returnerar dialogrutans basenheter i bildpunkter. Koordinaterna är relativa till dialogrutans ursprung.