Algemene besturingsparameters

Hier volgt een beschrijving van de algemene syntaxis voor een instructie van een besturingselementresourcedefinitie. De betekenis van elke parameter wordt hieronder gegeven. Af en toe gebruikt een instructie een andere parameter of negeert een parameter. De instructiespecifieke variatie wordt beschreven in de documentatie voor de instructie.

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

tekst

Tekst die met het besturingselement moet worden weergegeven. De tekst bevindt zich in het besturingselement of naast het besturingselement.

Deze parameter moet nul of meer tekens bevatten tussen dubbele aanhalingstekens ("). Tekenreeksen worden automatisch null-beëindigd en geconverteerd naar Unicode in het resulterende resourcebestand.

De tekens tussen de dubbele aanhalingstekens zijn standaard ANSI-tekens en escapereeksen worden geïnterpreteerd als byte escapereeksen. Als de tekenreeks wordt voorafgegaan door het voorvoegsel 'L', is de tekenreeks een tekenreeks met breed teken en worden escapereeksen geïnterpreteerd als escapereeksen van twee bytes die Unicode-tekens opgeven. Als een dubbel aanhalingsteken is vereist in de tekst, moet u het dubbele aanhalingsteken twee keer opnemen.

Een ampersandteken (&) in de tekst geeft aan dat het volgende teken wordt gebruikt als een nemonic teken voor het besturingselement. Wanneer het besturingselement wordt weergegeven, wordt het en-teken niet weergegeven, maar wordt het nemonische teken onderstreept. De gebruiker kan het besturingselement kiezen door op de toets te drukken die overeenkomt met het onderstreepte mnemonic-teken. Als u het en-teken als teken in een tekenreeks wilt gebruiken, voegt u twee ampersands (&&) in.

id

Besturingselement-id. Deze waarde moet een 16-bits geheel getal zonder teken zijn in het bereik 0 tot en met 65.535 of een eenvoudige rekenkundige expressie die resulteert in een waarde in dat bereik.

x-

X-coördinaat van de linkerkant van het besturingselement ten opzichte van de linkerkant van het dialoogvenster. Deze waarde moet een 16-bits geheel getal zonder teken zijn in het bereik 0 tot en met 65.535. De coördinaat bevindt zich in dialoogvensters en is relatief ten opzichte van de oorsprong van het dialoogvenster, het venster of het besturingselement met het opgegeven besturingselement.

y-

Y-coördinaat van de bovenzijde van het besturingselement ten opzichte van de bovenkant van het dialoogvenster. Deze waarde moet een 16-bits geheel getal zonder teken zijn in het bereik 0 tot en met 65.535. De coördinaat bevindt zich in dialoogvenstereenheden ten opzichte van de oorsprong van het dialoogvenster, venster of besturingselement met het opgegeven besturingselement.

breedte

Breedte van het besturingselement. Deze waarde moet een 16-bits geheel getal zonder teken zijn in het bereik 1 tot en met 65.535. De breedte is in eenheden van 1/4 tekens.

hoogte

Hoogte van het besturingselement. Deze waarde moet een 16-bits geheel getal zonder teken zijn in het bereik 1 tot en met 65.535. De hoogte is in eenheden van 1/8 tekens.

stijl

Besturingsstijlen. Gebruik de operator bitwise OR (|) om stijlen te combineren. Zie Vensterstijlenvoor meer informatie.

uitgebreide

Uitgebreide vensterstijlen. U moet stijl opgeven om uitgebreide stijlop te geven. Zie EXSTYLEvoor meer informatie.

helpId-

Numerieke expressie die de id aangeeft die wordt gebruikt om het besturingselement te identificeren tijdens WM_HELP verwerking.

controlData

Besturingsspecifieke gegevens voor het besturingselement. Wanneer er een dialoogvenster wordt gemaakt en er een besturingselement in dat dialoogvenster met besturingsspecifieke gegevens wordt gemaakt, wordt een aanwijzer naar die gegevens doorgegeven aan de vensterprocedure van het besturingselement via de lParam- van het WM_CREATE bericht voor dat besturingselement.

Opmerkingen

Horizontale dialoogvenstereenheden zijn 1/4 van de eenheid met basisbreedte van het dialoogvenster. Verticale eenheden zijn 1/8 van de basishoogteeenheid van het dialoogvenster. De huidige dialoogvensterbasiseenheden worden berekend op basis van de hoogte en breedte van het huidige systeemlettertype. De functie GetDialogBaseBaseUnits retourneert de dialoogvensterbasiseenheden in pixels. De coördinaten zijn relatief ten opzichte van de oorsprong van het dialoogvenster.