CREATESTRUCTW-Struktur (winuser.h)

Artikel
11/20/2024

Definiert die Initialisierungsparameter, die an die Fensterprozedur einer Anwendung übergeben werden. Diese Member sind identisch mit den Parametern der CreateWindowEx-Funktion.

Syntax

typedef struct tagCREATESTRUCTW {
  LPVOID    lpCreateParams;
  HINSTANCE hInstance;
  HMENU     hMenu;
  HWND      hwndParent;
  int       cy;
  int       cx;
  int       y;
  int       x;
  LONG      style;
  LPCWSTR   lpszName;
  LPCWSTR   lpszClass;
  DWORD     dwExStyle;
} CREATESTRUCTW, *LPCREATESTRUCTW;

Angehörige

lpCreateParams

Typ: LPVOID-

Enthält zusätzliche Daten, die zum Erstellen des Fensters verwendet werden können. Wenn das Fenster als Ergebnis eines Aufrufs des CreateWindow oder CreateWindowEx--Funktion erstellt wird, enthält dieses Element den Wert des lpParam- Parameters, der im Funktionsaufruf angegeben ist.

Wenn das erstellte Fenster ein MDI-Clientfenster ist, enthält dieses Element einen Zeiger auf eine CLIENTCREATESTRUCT Struktur. Wenn das erstellte Fenster ein untergeordnetes MDI-Fenster ist, enthält dieses Element einen Zeiger auf eine MDICREATESTRUCT Struktur.

Wenn das Fenster aus einer Dialogfeldvorlage erstellt wird, ist dieses Element die Adresse eines SHORT--Werts, der die Größe der Fenstererstellungsdaten in Byte angibt. Der Wert folgt unmittelbar auf die Erstellungsdaten. Weitere Informationen finden Sie im folgenden Abschnitt "Hinweise".

hInstance

Typ: HINSTANCE-

Ein Handle für das Modul, das das neue Fenster besitzt.

hMenu

Typ: HMENU

Ein Handle für das Menü, das vom neuen Fenster verwendet werden soll.

hwndParent

Typ: HWND-

Ein Handle für das übergeordnete Fenster, wenn es sich bei dem Fenster um ein untergeordnetes Fenster handelt. Wenn das Fenster im Besitz ist, identifiziert dieses Mitglied das Besitzerfenster. Wenn das Fenster kein untergeordnetes oder im Besitz befindliches Fenster ist, ist dieses Element NULL-.

cy

Typ: int

Die Höhe des neuen Fensters in Pixel.

cx

Typ: int

Die Breite des neuen Fensters in Pixel.

y

Typ: int

Die Y-Koordinate der oberen linken Ecke des neuen Fensters. Wenn es sich bei dem neuen Fenster um ein untergeordnetes Fenster handelt, sind Koordinaten relativ zum übergeordneten Fenster. Andernfalls sind die Koordinaten relativ zum Bildschirmursprung.

x

Typ: int

Die x-Koordinate der oberen linken Ecke des neuen Fensters. Wenn es sich bei dem neuen Fenster um ein untergeordnetes Fenster handelt, sind Koordinaten relativ zum übergeordneten Fenster. Andernfalls sind die Koordinaten relativ zum Bildschirmursprung.

style

Typ: LONG

Die Formatvorlage für das neue Fenster. Eine Liste der möglichen Werte finden Sie unter Fensterformatvorlagen.

lpszName

Typ: LPCTSTR-

Der Name des neuen Fensters.

lpszClass

Typ: LPCTSTR-

Ein Zeiger auf eine mit Null beendete Zeichenfolge oder ein Atom, der den Klassennamen des neuen Fensters angibt.

dwExStyle

Typ: DWORD-

Die Formatvorlage für das erweiterte Fenster für das neue Fenster. Eine Liste der möglichen Werte finden Sie unter erweiterten Fensterformatvorlagen.

Bemerkungen

Da das lpszClass Member einen Zeiger auf ein lokales (und somit nicht zugängliches) Atom enthalten kann, rufen Sie den Klassennamen nicht mithilfe dieses Elements ab. Verwenden Sie stattdessen die GetClassName--Funktion.

Sie sollten auf die daten zugreifen, die durch das lpCreateParams Member dargestellt werden, indem Sie einen Zeiger verwenden, der mithilfe des UNALIGNED- Typs deklariert wurde, da der Zeiger möglicherweise nicht DWORD- ausgerichtet ist. Dies wird im folgenden Beispiel veranschaulicht:

typedef struct tagMyData 
{
    // Define creation data here. 
} MYDATA; 
 
typedef struct tagMyDlgData 
{ 
    SHORT   cbExtra; 
    MYDATA  myData; 
} MYDLGDATA, UNALIGNED *PMYDLGDATA; 
 
PMYDLGDATA pMyDlgdata = (PMYDLGDATA) (((LPCREATESTRUCT) lParam)->lpCreateParams);

Anmerkung

Der winuser.h-Header definiert CREATESTRUCT als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 2000 Professional [nur Desktop-Apps]
mindestens unterstützte Server-	Windows 2000 Server [nur Desktop-Apps]
Header-	winuser.h (enthalten Windows.h)