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

CreateDialogIndirect

CreateDialogIndirectParam

Createwindowex

DialogBoxIndirect

DialogBoxIndirectParam

DLGTEMPLATEEX

MapDialogRect

WM_CREATE

Konzept

Dialogfelder

Andere Ressourcen

MultiByteToWideChar

WM_HELP