Allgemeine Steuerelementparameter

Im Folgenden wird die allgemeine Syntax für eine Steuerelementressourcendefinitionsanweisung beschrieben. Die Bedeutung der einzelnen Parameter wird unten angegeben. Gelegentlich verwendet eine Anweisung einen Parameter anders oder ignoriert 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 doppelte Anführungszeichen (") eingeschlossen sind. Zeichenfolgen werden automatisch null-beendet und in Unicode in der resultierenden Ressourcendatei 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 ist, wird die Zeichenfolge 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 einfügen.

Ein kaufmännisches Und-Zeichen (&) im Text gibt an, dass das folgende Zeichen als Mnemonic-Zeichen für das Steuerelement verwendet wird. Wenn das Steuerelement angezeigt wird, wird das kaufmännische Und-Zeichen nicht angezeigt, aber das mnemonic-Zeichen wird unterstrichen. Der Benutzer kann das Steuerelement auswählen, indem er die taste drückt, die dem unterstrichenen Mnemonic-Zeichen entspricht. Um das kaufmännische Und-Zeichen als Zeichen in einer Zeichenfolge zu verwenden, fügen Sie zwei kaufmännische Und-Zeichen (&&) ein.

id

Steuerelementbezeichner. Dieser Wert muss eine 16-Bit-Ganzzahl ohne Vorzeichen im Bereich 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 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 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 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 1 bis 65.535 sein. Die Höhe beträgt 1/8 Zeichen.

formatieren

Steuerelementformatvorlagen. Verwenden Sie den bitweisen OR (|)-Operator, um Formatvorlagen zu kombinieren. Weitere Informationen finden Sie unter Fensterformatvorlagen.

erweiterten

Erweiterte Fensterformatvorlagen. Sie müssen Formatvorlage angeben, um erweitertenanzugeben. 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 mit steuerelementspezifischen Daten erstellt wird, wird ein Zeiger auf diese Daten über die lParam- der WM_CREATE Nachricht für dieses Steuerelement in die Fensterprozedur des Steuerelements übergeben.

Bemerkungen

Horizontale Dialogfeldeinheiten sind 1/4 der Basisbreiteneinheit des Dialogfelds. 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 Pixeln zurück. Die Koordinaten sind relativ zum Ursprung des Dialogfelds.