DLGITEMTEMPLATE

Die DLGITEMTEMPLATE -Struktur definiert die Abmessungen und den Stil eines Steuerelements in einem Dialogfeld angezeigt. Ein oder mehrere dieser Strukturen sind kombiniert mit einer DLGTEMPLATE Struktur bilden eine Standardvorlage für ein Dialogfeld.

typedef Struct {/ / Dlit DWORD Stil; 
    DWORD DwExtendedStyle; 
    kurze X; 
    kurze y; 
    kurze Cx; 
    kurze cy; 
    WORD-Id; 
} DLGITEMTEMPLATE 

 

Mitglieder

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).

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.

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.

Bemerkungen

In einer Standardvorlage für ein Dialogfeld folgt die DLGITEMTEMPLATE Struktur immer sofort drei Arrays variabler Länge der Klasse, Titel und Erstellung Daten für das Steuerelement angeben. Jedes Array besteht aus mindestens 16-Bit-Elemente.

Jede DLGITEMTEMPLATE Struktur in der Vorlage muss auf ein DWORD -Grenzen ausgerichtet werden. Die Klasse und Titel-Arrays müssen auf Wortgrenzen ausgerichtet werden. Die Schöpfung-Daten-Array muss bei einer Wortgrenze ausgerichtet werden.

Unmittelbar nach jeder DLGITEMTEMPLATE Struktur ist ein Klasse-Array, das 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 des eine registrierte Fensterklasse. 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.

Nach das Klasse Array ist ein Array der Titel, 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 einer Ressource, z. B. ein Symbol in einer ausführbaren Datei angibt. 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.

Die Schöpfung-Daten-Array beginnt bei der nächsten Wortgrenze nach der Titel-Array. Diese Erstellung-Daten können mit beliebiger Größe und Format sein. Wenn das erste Wort der Schöpfung Datenarrays ungleich NULL ist, gibt die Größe in Bytes, der die Schöpfung-Daten (einschließlich das Wort Größe) an. 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.

Wenn Sie Zeichenfolgen in die Klasse und Titel-Arrays 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.1 oder höher erforderlich.
Windows:Erfordert Windows 95 oder höher.
Windows CE:Version 1.0 oder höher benötigt.
Header:In winuser.h deklarierten.

Siehe auch

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

Index