DLGITEMTEMPLATEEX

Die DLGITEMTEMPLATEEX -Struktur ist nicht in jedem standard-Header-Datei definiert. Die Strukturdefinition dient hier um zu erklären, das Format der eine erweiterte Vorlage für ein Dialogfeld.

Für jedes Steuerelement in einem Dialogfeld hat eine erweitertes Dialogfeld Feld Vorlage einen Block von Daten, die das DLGITEMTEMPLATEEX -Format verwendet, um das Steuerelement zu beschreiben. Eine Beschreibung des Formats der ein erweitertes Dialogfeld Feld Vorlage finden Sie unter DLGTEMPLATEEX.

typedef Struct {DWORD HilfeID; 
    DWORD ExStyle; 
    DWORD Stil; 
    kurze X; 
    kurze y; 
    kurze Cx; 
    kurze cy; 
    Id WORD; 
    Sz_Or_Ord WindowClass; / / Name oder Ordinalzahl einer Fenster-Klasse
    Sz_Or_Ord Titel;       / / title String oder Ordnungszahl einer Ressource
    WORD ExtraCount;     / / Bytes der folgenden Daten erstellen
} DLGITEMTEMPLATEEX 

 

Mitglieder

hilfeID

Gibt den Kontextbezeichner der Hilfe für das Steuerelement. Wenn das System sendet eine WM_HELP -Meldung, übergibt es den HilfeID -Wert im DwContextId -Member der HELPINFO Struktur.

dwExtendedStyle

Gibt erweiterte Stile für ein Fenster. Dieser Member wird nicht verwendet, um Steuerelemente in Dialogfeldern zu erstellen, aber Anwendungen, die Dialogfeldvorlagen verwenden können es verwenden, um andere Typen von Windows erstellen.

stil

Gibt den Stil des Steuerelements. Dieser Member kann eine Kombination der Fensterstilwerte (z. B. WS_BORDER) und eine oder mehrere der Kontrolle Stilwerte (z. B. BS_PUSHBUTTON und ES_LEFT).

x

Gibt die X-Koordinate, in Dialogfeld im Feld Einheiten, von der oberen linken Ecke des Steuerelements. Diese Koordinate ist immer relativ zu der oberen linken Ecke des Clientbereichs im Dialogfeld.

y

Gibt die y-Koordinate, in Dialogfeld im Feld Einheiten, von der oberen linken Ecke des Steuerelements. Diese Koordinate ist immer relativ zu der oberen linken Ecke des Clientbereichs im Dialogfeld.

cx

Gibt die Breite in Dialogfeld im Feld Einheiten des Steuerelements.

cy

Gibt die Höhe im Dialogfeld im Feld Einheiten, des Steuerelements.

id

Gibt die Steuerelement-ID.

windowClass

Gibt ein variabler Länge-Array von 16-Bit-Elemente, die Window-Klasse des Steuerelements identifiziert. Wenn das erste Element dieses Arrays einen anderen Wert als 0xFFFF ist, behandelt das System das Array als eine Null-terminierte Unicode-Zeichenfolge, die den Namen einer registrierten Fenster-Klasse.

Wenn das erste Element 0xFFFF ist, hat das Array ein zusätzliches Element, das den ordinalen-Wert einer vordefinierten Systemdaten-Klasse gibt. Die Ordnungszahl kann einer der folgenden Werte atom.

Wert	Bedeutung
0 x 0080	Schaltfläche
0x0081	Bearbeiten
0x0082	Statisch
0x0083	Listenfeld
0x0084	Bildlaufleiste
mit	Combo-box

titel

Gibt ein variabler Länge-Array von 16-Bit-Elemente, die den ursprünglichen Text oder Ressourcenbezeichner des Steuerelements enthält. Wenn das erste Element dieses Arrays 0xFFFF ist, hat das Array ein zusätzliches Element, das einen Ordinalwert angibt, der eine Ressource, z. B. ein Symbol, in einer ausführbaren Datei identifiziert. Einen Ressourcenbezeichner können für Steuerelemente, z. B. statisches Symbol, Sie, die laden und anzeigen, ein Symbol oder andere Ressource statt text.

Wenn das erste Element einen anderen Wert als 0xFFFF ist, behandelt das System das Array als eine Null-terminierte Unicode-Zeichenfolge, die den ursprünglichen Text gibt.

extraCount

Gibt die Anzahl der Bytes der Daten erstellen, die diesem Element folgen. Wenn dieser Wert größer als NULL ist, beginnt die Erstellung Daten bei der nächsten Wortgrenze . Diese Erstellung-Daten können mit beliebiger Größe und Format sein. Fensterprozedur des Steuerelements muss die Daten zu interpretieren. Wenn das System das Steuerelement erstellt, übergibt es einen Zeiger auf Daten im Parameter lParam der Nachricht WM_CREATE , die das an das Steuerelement gesendet.

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 auf ein DWORD -Grenzen ausgerichtet werden. Das WindowClass und Titel Arrays variabler Länge müssen auf Wortgrenzen ausgerichtet werden. Das Daten-Array erstellen, muss ggf. bei einer Wortgrenze ausgerichtet werden.

Wenn Sie Zeichenfolgen in den Arrays WindowClass und Titel angeben, müssen Sie Unicode-Zeichenfolgen verwenden. Um Code zu erstellen, die auf Windows und Windows NT funktioniert, verwenden Sie die Funktion MultiByteToWideChar diese Unicode-Zeichenfolgen generieren.

Die X, y, Cxund cy -Member angeben Werte im Dialogfeld im Feld Einheiten. Sie können diese Werte in Einheiten (Pixel) Bildschirm konvertieren, mithilfe der Funktion MapDialogRect.

QuickInfo

&Nbsp; Windows NT: Version 3.51 oder höher erforderlich.
Windows:Erfordert Windows 95 oder höher.
Windows CE:Nicht unterstützt.

Siehe auch

Übersicht über Dialogfelder, Dialogfeld Feld Strukturen, CreateDialogIndirect, CreateDialogIndirectParam, CreateWindowEx, DialogBoxIndirect, DialogBoxIndirectParam, DLGITEMTEMPLATE DLGTEMPLATE, DLGTEMPLATEEX, MapDialogRect, MultiByteToWideChar

Index