DLGITEMTEMPLATEEX-Struktur
Ein Textblock, der von einer Vorlage für erweiterte Dialogfelder verwendet wird, um das erweiterte Dialogfeld zu beschreiben. Eine Beschreibung des Formats einer Vorlage für erweiterte Dialogfelder finden Sie unter DLGTEMPLATEEX.
Syntax
typedef struct {
DWORD helpID;
DWORD exStyle;
DWORD style;
short x;
short y;
short cx;
short cy;
DWORD id;
sz_Or_Ord windowClass;
sz_Or_Ord title;
WORD extraCount;
} DLGITEMTEMPLATEEX;
Member
-
helpID
-
Art: DWORD
-
Der Hilfekontextbezeichner für das Steuerelement. Wenn das System eine WM_HELP Nachricht sendet, übergibt es den helpID-Wert im dwContextId-Element der HELPINFO-Struktur .
-
exStyle
-
Art: DWORD
-
Die erweiterten Stile für ein Fenster. Dieses Element wird nicht zum Erstellen von Steuerelementen in Dialogfeldern verwendet, aber Anwendungen, die Dialogfeldvorlagen verwenden, können es verwenden, um andere Fenstertypen zu erstellen. Eine Liste der Werte finden Sie unter Erweiterte Fensterstile.
-
style
-
Art: DWORD
-
Das Format des Steuerelements. Dieser Member kann eine Kombination aus Fensterformatwerten (z . B. WS_BORDER) und mindestens einem der Steuerelementstilwerte (z. B. BS_PUSHBUTTON und ES_LEFT) sein.
-
x
-
Typ: short
-
Die x-Koordinate in Dialogfeldeinheiten der oberen linken Ecke des Steuerelements. Diese Koordinate ist immer relativ zur oberen linken Ecke des Clientbereichs des Dialogfelds.
-
y
-
Typ: short
-
Die y-Koordinate in Dialogfeldeinheiten der oberen linken Ecke des Steuerelements. Diese Koordinate ist immer relativ zur oberen linken Ecke des Clientbereichs des Dialogfelds.
-
Cx
-
Typ: short
-
Die Breite des Steuerelements in Dialogfeldeinheiten.
-
cy
-
Typ: short
-
Die Höhe des Steuerelements in Dialogfeldeinheiten.
-
ID
-
Art: DWORD
-
Der Steuerelementbezeichner.
-
windowClass
-
Typ: sz_Or_Ord
-
Ein Array mit variabler Länge von 16-Bit-Elementen, das die Fensterklasse des Steuerelements angibt. Wenn das erste Element dieses Arrays ein anderer Wert als 0xFFFF ist, behandelt das System das Array als mit NULL endende Unicode-Zeichenfolge, die den Namen einer registrierten Fensterklasse angibt.
Wenn das erste Element 0xFFFF ist, verfügt das Array über ein zusätzliches Element, das den Ordnungswert einer vordefinierten Systemklasse angibt. Die Ordnungszahl kann einer der folgenden Atomwerte sein.
Wert Bedeutung - 0x0080
Taste - 0x0081
Bearbeiten - 0x0082
statischen - 0x0083
Listenfeld - 0x0084
Bildlaufleiste - 0x0085
Kombinationsfeld -
title
-
Typ: sz_Or_Ord
-
Ein Array mit variabler Länge von 16-Bit-Elementen, das den Anfangstext oder den Ressourcenbezeichner des Steuerelements enthält. Wenn das erste Element dieses Arrays 0xFFFF ist, verfügt das Array über ein zusätzliches Element, das den Ordnungswert einer Ressource angibt, z. B. ein Symbol, in einer ausführbaren Datei. Sie können einen Ressourcenbezeichner für Steuerelemente verwenden, z. B. statische Symbolsteuerelemente, die anstelle von Text ein Symbol oder eine andere Ressource laden und anzeigen. Wenn das erste Element ein anderer Wert als 0xFFFF ist, behandelt das System das Array als mit NULL endende Unicode-Zeichenfolge, die den Anfangstext angibt.
-
extraCount
-
Typ: WORD
-
Die Anzahl der Byte der Erstellungsdaten, die diesem Member folgen. Wenn dieser Wert größer als 0 (null) ist, beginnen die Erstellungsdaten an der nächsten WORD-Grenze . Diese Erstellungsdaten können eine beliebige Größe und ein beliebiges Format aufweisen. Die Fensterprozedur des Steuerelements muss die Daten interpretieren können. Wenn das System das Steuerelement erstellt, übergibt es einen Zeiger auf diese Daten im lParam-Parameter der WM_CREATE Nachricht, die an das Steuerelement gesendet wird.
Bemerkungen
Eine erweiterte Vorlage für ein Dialogfeld besteht aus einem DLGTEMPLATEEX-Header gefolgt von einer DLGITEMTEMPLATEEX-Struktur für jedes Steuerelement im Dialogfeld.
Jede DLGITEMTEMPLATEEX-Struktur muss an einer DWORD-Grenze ausgerichtet werden. Die WindowClass - und Title-Arrays mit variabler Länge müssen an WORD-Grenzen ausgerichtet werden. Das Erstellungsdatenarray muss ggf. an einer WORD-Grenze ausgerichtet werden.
Wenn Sie Zeichenfolgen in den Arrays windowClass und title angeben, müssen Sie Unicode-Zeichenfolgen verwenden. Verwenden Sie die MultiByteToWideChar-Funktion , um Unicode-Zeichenfolgen aus ANSI-Zeichenfolgen zu generieren.
Die Elemente x, y, cx und cy geben Werte in Dialogfeldeinheiten an. Sie können diese Werte mithilfe der MapDialogRect-Funktion in Bildschirmeinheiten (Pixel) konvertieren.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows 2000 Server [nur Desktop-Apps] |
Siehe auch
-
Referenz
-
Konzept
-
Andere Ressourcen