Allgemeine Steuerelementparameter
Im Folgenden wird die allgemeine Syntax für eine Ressourcendefinitions-Anweisung des Steuerelements beschrieben. Die Bedeutung der einzelnen Parameter wird unten angegeben. Gelegentlich verwendet eine Anweisung einen Parameter anders oder ignoriert möglicherweise einen Parameter. Die anweisungsspezifische Variante 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 0 (null) oder mehr Zeichen enthalten, die in doppelte Anführungszeichen () eingeschlossen sind. Zeichenfolgen werden automatisch mit NULL beendet und in der resultierenden Ressourcendatei in Unicode konvertiert.
Standardmäßig sind die zeichen, die zwischen den doppelten Anführungszeichen aufgeführt sind, ANSI-Zeichen, und Escapesequenzen werden als Byte-Escapesequenzen interpretiert. Wenn der Zeichenfolge das Präfix "L" vorangestellt ist, ist die Zeichenfolge eine Breitzeichenzeichenfolge, und Escapesequenzen werden als 2-Byte-Escapesequenzen interpretiert, die Unicode-Zeichen angeben. Wenn ein doppeltes Anführungszeichen im Text erforderlich ist, müssen Sie das doppelte Anführungszeichen zweimal verwenden.
Ein ampersand-Zeichen (&) 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-Zeichen 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-Zeichen 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 Dialogeinheiten und ist relativ zum Ursprung des Dialogfelds, Fensters oder Steuerelements, das bzw. 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 Dialogeinheiten relativ zum Ursprung des Dialogfelds, Fensters oder Steuerelements, das bzw. 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 beträgt 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 beträgt 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 style angeben, um erweiterte Stile anzugeben. Weitere Informationen finden Sie unter EXSTYLE.
-
helpId
-
Numerischer Ausdruck, der die ID angibt, mit der das Steuerelement während der WM _ HELP-Verarbeitung identifiziert wird.
-
controlData
-
Steuerelementspezifische Daten für das Steuerelement. Wenn ein Dialogfeld erstellt wird und ein Steuerelement in diesem Dialogfeld mit steuerelementspezifischen Daten erstellt wird, wird ein Zeiger auf diese Daten über die lParam-Nachricht der WM _ CREATE-Nachricht für dieses Steuerelement an die Fensterprozedur des Steuerelements übergeben.
Bemerkungen
Horizontale Dialogeinheiten sind 1/4 der Basisbreiteneinheit des Dialogs. Vertikale Einheiten sind 1/8 der Basishöheneinheit des Dialogs. Die aktuellen Dialogbasiseinheiten werden aus der Höhe und Breite der aktuellen Systemschriftart berechnet. Die GetDialogBaseUnits-Funktion gibt die Basiseinheiten des Dialogs in Pixel zurück. Die Koordinaten sind relativ zum Ursprung des Dialogfelds.