Allgemeine Steuerungsparameter

Im Folgenden wird die allgemeine Syntax für eine Steuerelementressourcendefinitions-Anweisung beschrieben. Die Bedeutung der einzelnen Parameter wird unten angegeben. Gelegentlich verwendet eine Anweisung einen Parameter anders oder ignoriert möglicherweise einen Parameter. Die anweisungsspezifische Variation wird in der Dokumentation für die Anweisung beschrieben.

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

Text

Text, der mit dem Steuerelement angezeigt werden soll. Der Text wird innerhalb des Steuerelements oder neben dem Steuerelement positioniert.

Dieser Parameter muss null oder mehr Zeichen enthalten, die in doppelten Anführungszeichen (") eingeschlossen sind. Zeichenfolgen werden automatisch null beendet und in der resultierenden Ressourcendatei in Unicode konvertiert.

Standardmäßig sind die zwischen den doppelten Anführungszeichen aufgeführten Zeichen ANSI-Zeichen, und Escapesequenzen werden als Byte-Escapesequenzen interpretiert. Wenn der Zeichenfolge das Präfix "L" vorangestellt wird, ist die Zeichenfolge eine Breitzeichenzeichenfolge, und Escapesequenzen werden als 2-Byte-Escapesequenzen interpretiert, die Unicode-Zeichen angeben. Wenn im Text ein doppeltes Anführungszeichen erforderlich ist, müssen Sie das doppelte Anführungszeichen zweimal einfügen.

Ein Ampersandzeichen (&) im Text gibt an, dass das folgende Zeichen als mnemonisches Zeichen für das Steuerelement verwendet wird. Wenn das Steuerelement angezeigt wird, wird das Ampersand nicht angezeigt, aber das mnemonische Zeichen wird unterstrichen. Der Benutzer kann das Steuerelement auswählen, indem er die Taste drückt, die dem unterstrichenen mnemonischen Zeichen entspricht. Um das Ampersand als Zeichen in einer Zeichenfolge zu verwenden, fügen Sie zwei Ampersands (&&) ein.

Id

Steuerelement Dieser Wert muss eine 16-Bit-Ganzzahl ohne Vorzeichen im Bereich von 0 bis 65.535 oder ein einfacher arithmetischer Ausdruck sein, der zu einem Wert in diesem Bereich ausgewertet wird.

X

X-Koordinate der linken Seite des Steuerelements relativ zur linken Seite des Dialogfelds. Dieser Wert muss eine 16-Bit-Ganzzahl ohne Vorzeichen im Bereich von 0 bis 65.535 sein. Die Koordinate befindet sich in Dialogfeldeinheiten und ist relativ zum Ursprung des Dialogfelds, Fensters oder Steuerelements, das das angegebene Steuerelement enthält.

Y

Y-Koordinate der oberen Seite des Steuerelements relativ zum oberen Rand des Dialogfelds. Dieser Wert muss eine 16-Bit-Ganzzahl ohne Vorzeichen im Bereich von 0 bis 65.535 sein. Die Koordinate befindet sich in Dialogfeldeinheiten relativ zum Ursprung des Dialogfelds, Fensters oder Steuerelements, das das angegebene Steuerelement enthält.

Breite

Breite des Steuerelements. Dieser Wert muss eine 16-Bit-Ganzzahl ohne Vorzeichen im Bereich von 1 bis 65.535 sein. Die Breite ist in Einheiten mit 1/4 Zeichen.

Höhe

Höhe des Steuerelements. Dieser Wert muss eine 16-Bit-Ganzzahl ohne Vorzeichen im Bereich von 1 bis 65.535 sein. Die Höhe ist in Einheiten mit 1/8 Zeichen.

Stil

Steuerelementstile. Verwenden Sie den bitweisen OR-Operator (|), um Stile zu kombinieren. Weitere Informationen finden Sie unter Fensterstile.

erweiterter Stil

Erweiterte Fensterstile. Sie müssen die Formatvorlage angeben, um den erweiterten Stil anzugeben. Weitere Informationen finden Sie unter EXSTYLE.

helpId

Numerischer Ausdruck, der die ID angibt, die zum Identifizieren des Steuerelements während WM_HELP Verarbeitung verwendet wird.

controlData

Steuerelementspezifische Daten für das Steuerelement. Wenn ein Dialogfeld erstellt wird und ein Steuerelement in diesem Dialogfeld erstellt wird, das steuerelementspezifische Daten enthält, wird ein Zeiger auf diese Daten über die lParam der WM_CREATE Nachricht für dieses Steuerelement an die Fensterprozedur des Steuerelements übergeben.

Bemerkungen

Horizontale Dialogeinheiten sind 1/4 der Einheit der Dialogbasisbreite. Vertikale Einheiten sind 1/8 der Dialogbasishöheneinheit. Die aktuellen Dialogbasiseinheiten werden aus der Höhe und Breite der aktuellen Systemschriftart berechnet. Die GetDialogBaseUnits-Funktion gibt die Dialogbasiseinheiten in Pixel zurück. Die Koordinaten sind relativ zum Ursprung des Dialogfelds.