CREATESTRUCTA-Struktur (winuser.h)

Artikel
08/28/2023

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

Syntax

typedef struct tagCREATESTRUCTA {
  LPVOID    lpCreateParams;
  HINSTANCE hInstance;
  HMENU     hMenu;
  HWND      hwndParent;
  int       cy;
  int       cx;
  int       y;
  int       x;
  LONG      style;
  LPCSTR    lpszName;
  LPCSTR    lpszClass;
  DWORD     dwExStyle;
} CREATESTRUCTA, *LPCREATESTRUCTA;

Member

lpCreateParams

Typ: LPVOID

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

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

Wenn das Fenster aus einer Dialogvorlage erstellt wird, ist dieses Element die Adresse eines SHORT-Werts , der die Größe der Fenstererstellungsdaten in Bytes angibt. Auf den Wert folgen unmittelbar 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 das Fenster ein untergeordnetes Fenster ist. Wenn sich das Fenster im Besitz des Fensters befindet, identifiziert dieses Mitglied das Besitzerfenster. Wenn das Fenster kein untergeordnetes oder eigenes 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 das neue Fenster ein untergeordnetes Fenster ist, sind die 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 das neue Fenster ein untergeordnetes Fenster ist, sind die Koordinaten relativ zum übergeordneten Fenster. Andernfalls sind die Koordinaten relativ zum Bildschirmursprung.

style

Typ: LONG

Der Stil für das neue Fenster. Eine Liste der möglichen Werte finden Sie unter Fensterstile.

lpszName

Typ: LPCTSTR

Der Name des neuen Fensters.

lpszClass

Typ: LPCTSTR

Ein Zeiger auf eine NULL-endende Zeichenfolge oder ein Atom, das den Klassennamen des neuen Fensters angibt.

dwExStyle

Art: DWORD

Das erweiterte Fensterformat für das neue Fenster. Eine Liste der möglichen Werte finden Sie unter Erweiterte Fensterstile.

Hinweise

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

Sie sollten auf die daten zugreifen, die vom lpCreateParams-Element dargestellt werden, indem Sie einen Zeiger verwenden, der mit dem UNALIGNED-Typ 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);

Hinweis

Der winuser.h-Header definiert CREATESTRUCT als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch 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


Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Kopfzeile	winuser.h (windows.h einschließen)