CreateWindow

Die CreateWindow -Funktion erstellt eine überlappende, Popup-Fenster oder ein untergeordnetes Fenster. Es gibt die Fensterklasse, Fenstertitel, Fensterstil, und (optional) die ursprüngliche Position und Größe des Fensters. Die Funktion gibt auch das Fenster übergeordneten oder Besitzer, falls vorhanden und das Fenster-Menü.

Verwenden Sie erweiterte Stile zusätzlich zu den Formatvorlagen unterstützt von CreateWindowdie CreateWindowEx -Funktion anstelle von CreateWindow.

(HWND CreateWindow LPCTSTR  LpClassName, / / Zeiger auf registrierte KlassennameLPCTSTRlpWindowName, / / Zeiger auf Fenster-NameDWORDdwStyle, / / Fensterstilint x, / / horizontale Position des Fensters int y, / / vertikale Position des Fensters intnWidth, / / Fensterbreite intnHeight, / / FensterhöheHWNDhWndParent, / / handle für Eltern oder Eigentümer FensterHMENUhMenu, / / handle auf Menü oder ChildWindow BezeichnerBehandelnhInstance, / / handle für die AnwendungsinstanzLPVOIDLpParam / / Zeiger auf Daten, Fenster-Erstellung);
 

Parameter

lpClassName

Zeiger auf eine Null-terminierte Zeichenfolge oder eine Ganzzahl-Atom ist. Wenn dieser Parameter ein Atom ist, muss es eine globale Atom, erstellt von einem vorherigen Aufruf der GlobalAddAtom Funktion. Das Atom, ein 16-Bit-Wert kleiner als 0xC000, muß im niederwertigen Wort von LpClassName; das hohe Word muss NULL sein.

Wenn LpClassName eine Zeichenfolge ist, gibt es der Fensterklassenname. Der Klassenname kann einen beliebigen Namen mit der Funktion RegisterClassEx oder die vordefinierte Steuerelement-Klasse Namen registriert sein. Eine vollständige Liste finden Sie unter im Abschnitt Hinweise.

lpWindowName

Zeiger auf eine auf Null endende Zeichenfolge, die angibt, der Name des Fensters.

Wenn der Fensterstil eine Titelleiste angibt, wird der Fenstertitel mit LpWindowName verwiesen in der Titelleiste angezeigt. Wenn CreateWindow erstellen Sie Steuerelemente, z. B. Schaltflächen, Kontrollkästchen und statischen Steuerelemente verwenden Sie LpWindowName um den Text des Steuerelements anzugeben.

dwStyle

Gibt den Stil des Fensters erstellt wird. Dieser Parameter kann eine Kombination der folgenden Fensterstile und Steuerelementstilen angegeben im Abschnitt Hinweise.

Stil	Bedeutung
WS_BORDER	Erstellt ein Fenster, das hat eine dünne Rahmenlinie.
WS_CAPTION	Erstellt ein Fenster, das eine Titelleiste hat (beinhaltet die Formatvorlage WS_BORDER).
WS_CHILD	Erstellt ein untergeordnetes Fenster. Dieser Stil kann nicht mit dem WS_POPUP Stil verwendet werden.
WS_CHILDWINDOW	Dasselbe wie das Format WS_CHILD.
WS_CLIPCHILDREN	Schließt den Bereich von untergeordneten Fenstern belegt, tritt Zeichnung innerhalb des übergeordneten Fensters. Dieser Stil wird verwendet, wenn das übergeordnete Fenster erstellen.
WS_CLIPSIBLINGS	Clips untergeordnete Fenster relativ zueinander; Das heißt, wenn ein bestimmtes untergeordnetes Fenster erhält eine WM_PAINT -Meldung, clips der WS_CLIPSIBLINGS-Stil alle anderen überlappenden untergeordnete Fenster aus der Region des untergeordneten Fensters aktualisiert werden. Wenn WS_CLIPSIBLINGS nicht angegeben ist und untergeordnete Fenster überlappen, ist es möglich, wenn im Clientbereich eines untergeordneten Fensters, um im Clientbereich eines benachbarten untergeordneten Fensters zeichnen Zeichnung.
WS_DISABLED	Erstellt ein Fenster, das anfänglich deaktiviert ist. Eine deaktivierte Fenster kann nicht vom Benutzer Eingaben erhalten.
WS_DLGFRAME	Erstellt ein Fenster, das einen Rahmen von einem Stil in der Regel mit Dialogfeldern verwendet hat. Ein Fenster mit diesem Stil keine Titelleiste.
WS_GROUP	Gibt das erste Steuerelement eine Gruppe von Steuerelementen. Die Gruppe besteht aus dieser ersten Steuerelement und Steuerelemente definiert nach, bis das nächste Steuerelement mit dem WS_GROUP Stil. Das erste Steuerelement in jeder Gruppe hat in der Regel den WS_TABSTOP Stil, so dass der Benutzer von Gruppe zu Gruppe wechseln kann. Der Benutzer kann anschließend den Tastaturfokus von einem Steuerelement in der Gruppe auf das nächste Steuerelement in der Gruppe ändern mithilfe der Richtungstasten.
WS_HSCROLL	Erstellt ein Fenster mit eine horizontalen Bildlaufleiste.
WS_ICONIC	Erstellt ein Fenster, das anfänglich minimiert ist. Identisch mit dem WS_MINIMIZE-Stil.
WS_MAXIMIZE	Erstellt ein Fenster, das anfänglich maximiert angezeigt wird.
WS_MAXIMIZEBOX	Erstellt ein Fenster, das eine Schaltfläche zum Maximieren verfügt. Kann nicht mit dem WS_EX_CONTEXTHELP-Stil kombiniert werden. WS_SYSMENU Stil muss ebenfalls angegeben werden.
WS_MINIMIZE	Erstellt ein Fenster, das anfänglich minimiert ist. Identisch mit den WS_ICONIC-Stil.
WS_MINIMIZEBOX	Erstellt ein Fenster, das eine Minimieren-Schaltfläche verfügt. Kann nicht mit dem WS_EX_CONTEXTHELP-Stil kombiniert werden. WS_SYSMENU Stil muss ebenfalls angegeben werden.
WS_OVERLAPPED	Erstellt eine überlappende Fenster. Eine überlappende Fenster eine Titelleiste verfügt und eine Grenze. Identisch mit den WS_TILED-Stil.
WS_OVERLAPPEDWINDOW	Erstellt eine überlappende Fenster mit der WS_OVERLAPPED, WS_CAPTION, WS_SYSMENU, WS_THICKFRAME, WS_MINIMIZEBOX und WS_MAXIMIZEBOX Stile. Identisch mit den WS_TILEDWINDOW-Stil.
WS_POPUP	Erstellt ein Popup-Fenster. Dieser Stil kann nicht mit dem WS_CHILD-Stil verwendet werden.
WS_POPUPWINDOW	Erstellt ein Popup-Fenster mit WS_BORDER, WS_POPUP und WS_SYSMENU Stile. WS_CAPTION und WS_POPUPWINDOW Stile müssen kombiniert werden, um im Fenstermenü sichtbar zu machen.
WS_SIZEBOX	Erstellt ein Fenster, das einen Größenanpassungsrahmens hat. Dasselbe wie die WS_THICKFRAME-Stil.
WS_SYSMENU	Erstellt ein Fenster, das Menü-Fenster auf die Titelleiste klickten. Der Stil WS_CAPTION muss ebenfalls angegeben werden.
WS_TABSTOP	Gibt ein Steuerelement, das den Tastaturfokus erhalten kann, wenn der Benutzer die Tab-Taste drückt. Die Tab-Taste ändert sich den Tastaturfokus auf das nächste Steuerelement mit WS_TABSTOP Stil.
WS_THICKFRAME	Erstellt ein Fenster, das einen Größenanpassungsrahmens hat. Gleich wie bei der WS_SIZEBOX.
WS_TILED	Erstellt eine überlappende Fenster. Eine überlappende Fenster eine Titelleiste verfügt und eine Grenze. Identisch mit der WS_OVERLAPPED-Formatvorlage.
WS_TILEDWINDOW	Erstellt eine überlappende Fenster mit der WS_OVERLAPPED, WS_CAPTION, WS_SYSMENU, WS_THICKFRAME, WS_MINIMIZEBOX und WS_MAXIMIZEBOX Stile. Gleich wie bei der WS_OVERLAPPEDWINDOW.
WS_VISIBLE	Erstellt ein Fenster, das anfänglich sichtbar ist.
WS_VSCROLL	Erstellt ein Fenster, das eine vertikale Bildlaufleiste hat.

x

Gibt die horizontale Anfangsposition des Fensters. Für eine überlappende oder Popup-Fenster ist der X -Parameter die erste X-Koordinate der oberen linken Ecke des Fensters, in Bildschirmkoordinaten. Für ein untergeordnetes Fenster ist x die X-Koordinate von der oberen linken Ecke des Fensters in Bezug auf der oberen linken Ecke des Clientbereichs des übergeordneten Fensters.

Wenn dieser Parameter auf CW_USEDEFAULT festgelegt ist, wird das System selektiert die Standardposition für die obere linke Ecke des Fensters und den y -Parameter ignoriert. CW_USEDEFAULT ist gültig nur für überlappende Fenster; Wenn es für angegeben ist, sind ein Popup-Fenster oder ein untergeordnetes Fenster, die x- und y -Parameter auf NULL gesetzt.

y

Gibt die anfängliche vertikale Position des Fensters. Für eine überlappende oder Popup-Fenster ist der y -Parameter die erste y-Koordinate der oberen linken Ecke des Fensters, in Bildschirmkoordinaten. Für ein untergeordnetes Fenster ist y die erste y-Koordinate der oberen linken Ecke des untergeordneten Fensters in Bezug auf der oberen linken Ecke des Clientbereichs des übergeordneten Fensters. Für ein Listenfeld ist y die erste y-Koordinate der oberen linken Ecke des Clientbereichs im Listenfeld relativ zu der oberen linken Ecke des Clientbereichs des übergeordneten Fensters.

Wenn eine überlappende Fenster mit festgelegtem Bit Style WS_VISIBLE erstellt wird und der X -Parameter auf CW_USEDEFAULT festgelegt ist, ignoriert das System den y -parameter.

nWidth

Gibt die Breite in Geräteeinheiten des Fensters. NWidth in überlappenden Windows entweder die Breite des Fensters, in Bildschirmkoordinaten oder CW_USEDEFAULT ist. Wenn nWidth CW_USEDEFAULT ist, wählt das System eine Standardbreite und Höhe des Fensters; die Standardbreite erstreckt sich von der ersten X-Koordinate an den rechten Rand des Bildschirms, und die Standardhöhe erstreckt sich von der ersten y-Koordinate an die Spitze der Bereich Symbol. CW_USEDEFAULT ist gültig nur für überlappende Fenster; Wenn für ein Popup-Fenster oder ein untergeordnetes Fenster CW_USEDEFAULT angegeben ist, werden nWidth und nHeight auf NULL gesetzt.

nHeight

Gibt die Höhe in Geräteeinheiten des Fensters. Für überlappende Fenster ist nHeight die Höhe des Fensters, in Bildschirmkoordinaten. Wenn nWidth CW_USEDEFAULT festgelegt ist, ignoriert das System nHeight.

hWndParent

Handle für das übergeordnete oder Eigentümer Fenster des Fensters erstellt wird. Um ein untergeordnetes Fenster oder ein Besitzfenster erstellen, geben Sie ein gültiges Fensterhandle. Dieser Parameter ist optional für Popup-Fenster.

Windows NT 5.0 und höher: Um eine nur-Nachrichten-Fenster zu erstellen, geben Sie HWND_MESSAGE oder ein Handle zu einem vorhandenen nur-Nachrichten-Fenster.

hMenu

Handle für ein Menü, oder gibt einen ChildWindow Bezeichner abhängig von den Fensterstil. Für eine überlappende oder Pop-up Fenster identifiziert hMenu das Menü für das Fenster verwendet werden; Es kann NULL sein, wenn das Klasse im Menü verwendet werden. Für ein untergeordnetes Fenster gibt hMenu die ChildWindow ID, einen Integer-Wert von einem Dialogfeld-Steuerelement verwendet, um die übergeordneten über Ereignisse zu benachrichtigen. Die Anwendung ermittelt die ChildWindow ID; Es muss für alle untergeordneten Fenster mit dem gleichen übergeordneten Fenster eindeutig sein.

hInstance

Behandeln Sie, um die Instanz des Moduls im Fenster zugeordnet werden.

lpParam

Ein Zeiger auf einen Wert an das Fenster über die CREATESTRUCT -Struktur übergeben werden übergeben in den lParam -Parameter die WM_CREATE -Nachricht. Wenn eine Anwendung fordert CreateWindow-Funktion ein mehrere Dokument Interface (MDI) Client-Fenster erstellen, muss LpParam auf eine CLIENTCREATESTRUCT -Struktur zeigen.

Rückgabewerte

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Handle für das neue Fenster.

Wenn die Funktion fehlschlägt, ist der Rückgabewert NULL. Rufen Sie Fehlerinformationen verlängert bekommen, GetLastError.

Bemerkungen

Vor der Rückkehr, sendet CreateWindow eine WM_CREATE -Nachricht an die Fensterprozedur. Für Pop-up, und untergeordnete Fenster, überlappend sendet CreateWindow WM_CREATE, WM_GETMINMAXINFOund WM_NCCREATE Meldungen an das Fenster. Der Parameter lParam der Nachricht WM_CREATE enthält einen Zeiger auf eine CREATESTRUCT -Struktur. Wenn der Style WS_VISIBLE angegeben wird, sendet CreateWindow Fenster alle Nachrichten zu aktivieren und Anzeigen des Fensters erforderlich.

Informationen zu steuern, ob die Taskleiste eine Schaltfläche für das erstellte Fenster zeigt, finden Sie unter Sichtbarkeit von Taskleistenschaltflächen.

Die folgenden vordefinierten Steuerelementklassen können im Parameter LpClassName angegeben werden. Beachten Sie, dass Sie das entsprechende Steuerelement Stile kann in den DwStyle -Parameter verwenden.

Windows 95:Das System unterstützt maximal 16.364 Fenstergriffe.

Hinweis&Nbsp; Wenn Sie Windows Version 4.x angeben, wenn Ihre Anwendung verknüpfen, nicht seine Fenster Schaltflächen mit Beschriftung, es sei denn, sie auch Menüs haben. Dies ist nicht erforderlich, wenn Sie Windows Version 3.x angeben, wenn Ihre Anwendung verknüpfen.

Windows CE: CreateWindow-Funktion ist als Makro implementiert. Es ist definiert als CreateWindowEx, sondern mit der DwExStyle Parameter auf 0 L.

Menüleisten werden nicht unterstützt. Der hMenu -Parameter muss NULL sein, es sei denn, es als ein ChildWindow Bezeichner verwendet wird.

Die MDICLIENT-Fenster-Klasse wird nicht unterstützt.

Der DwStyle -Parameter kann eine Kombination aus dem Fensterstile und Steuerelementstilen dokumentiert in:

Dialogfelder

Windows

Steuerelemente

Die folgenden DwStyle -Flags sind für Windows nicht unterstützt.:

Die folgenden DwStyle -Flags sind für Steuerelemente und Dialogfelder nicht unterstützt.:

BS_OWNERDRAW Stil können Sie als Ersatz für den BS_USERBUTTON-Stil.

Den SS_LEFT oder SS_LEFTNOWORDWRAP Stil können statt des SS_SIMPLE Stils für statische Steuerelemente Sie..

Die MDICLIENT-Fenster-Klasse wird nicht unterstützt.

Alle Fenster haben implizit die Stile WS_CLIPSIBLINGS und WS_CLIPCHILDREN.

Besitzfenster, mit Ausnahme für Dialogfelder unterstützt Windows CE 1.0 nicht. Wenn der HwndParent -Parameter nicht NULL ist, wird das Fenster implizit das Format WS_CHILD gegeben.

Windows CE Version 1.0 unterstützt keine Menüleisten.

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.
Importieren Bibliothek:Verwenden Sie user32.lib.
Unicode:Als Unicode und ANSI-Versionen unter Windows NT implementiert.

Siehe auch

Übersicht über Windows Fenster Funktionen, CLIENTCREATESTRUCT, CREATESTRUCT, CreateWindowEx, GlobalAddAtom, RegisterClassEx, WM_COMMAND, WM_CREATE, WM_GETMINMAXINFO, WM_NCCREATE, WM_PAINT

Index