CreateWindowEx

Die CreateWindowEx -Funktion erstellt eine überlappende, Popup-Fenster oder ein untergeordnetes Fenster mit einem erweiterten Stil; Andernfalls ist diese Funktion identisch mit der CreateWindow -Funktion. Weitere Informationen zum Erstellen eines Fensters und vollständige Beschreibungen der anderen Parameter der CreateWindowExfinden Sie CreateWindow.

HWND CreateWindowEx) DWORD  DwExStyle, / / erweiterter FensterstilLPCTSTRlpClassName, / / Zeiger auf registrierte KlassennameLPCTSTRlpWindowName, / / Zeiger auf Fenster-NameDWORDdwStyle, / / Fensterstil int 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 die ChildWindow BezeichnerHINSTANCEhInstance, / / handle für die AnwendungsinstanzLPVOIDLpParam / / Zeiger auf Daten, Fenster-Erstellung);
 

Parameter

dwExStyle

Gibt den erweiterten Stil des Fensters. Dieser Parameter kann eine der folgenden Werte sein:

Stil	Bedeutung
WS_EX_ACCEPTFILES	Gibt an, dass ein Fenster mit diesem Stil erstellt Drag & Drop-Dateien akzeptiert.
WS_EX_APPWINDOW	Erzwingt ein Fenster der obersten Ebene auf der Taskleiste, wenn das Fenster sichtbar ist.
WS_EX_CLIENTEDGE	Gibt an, dass ein Fenster einen Rahmen mit einer abgesenkten Kante hat.
WS_EX_CONTEXTHELP	Enthält ein Fragezeichen in der Titelleiste des Fensters. Klickt der Benutzer das Fragezeichen, ändert sich der Cursor in ein Fragezeichen mit einem Zeiger. Wenn der Benutzer dann ein untergeordnetes Fenster klickt, erhält das Kind eine WM_HELP-Meldung. Das untergeordnete Fenster sollte die Nachricht an die übergeordnete Fensterprozedur übergeben, das die WinHelp -Funktion mit dem HELP_WM_HELP Befehl aufrufen soll. Die Hilfeanwendung zeigt ein Popup-Fenster, die in der Regel Hilfe für das untergeordnete Fenster enthält. WS_EX_CONTEXTHELP kann nicht mit dem WS_MAXIMIZEBOX oder WS_MINIMIZEBOX verwendet werden.
WS_EX_CONTROLPARENT	Ermöglicht dem Benutzer, unter die untergeordneten Fenster des Fensters navigieren, indem Sie die Tab-Taste.
WS_EX_DLGMODALFRAME	Erstellt ein Fenster, das einen doppelten Rahmen hat; Das Fenster kann optional mit einer Titelzeile erstellt werden durch Angabe den Stil WS_CAPTION im DwStyle -parameter.
WS_EX_LEFT	Fenster hat generische "Linksbündig" Eigenschaften. Dies ist die Standardeinstellung.
WS_EX_LEFTSCROLLBAR	Wenn die Shell-Sprache ist Hebräisch, Arabisch oder einer anderen Sprache lesen Reihenfolge Ausrichtung unterstützt, ist die vertikale Bildlaufleiste (sofern vorhanden) auf der linken Seite des Clientbereichs. Für andere Sprachen der Stil ignoriert und nicht als Fehler behandelt.
WS_EX_LTRREADING	Der Fenstertext wird mithilfe von links nach rechts Leserichtung Eigenschaften angezeigt. Dies ist die Standardeinstellung.
WS_EX_MDICHILD	Erstellt ein untergeordnetes MDI-Fenster.
WS_EX_NOPARENTNOTIFY	Gibt an, dass ein untergeordnetes Fenster mit dieser Formatvorlage erstellt keine sendet die WM_PARENTNOTIFY -Nachricht an sein übergeordnetes Fenster wenn es erstellt oder zerstört wird.
WS_EX_OVERLAPPEDWINDOW	Verbindet die Stile WS_EX_CLIENTEDGE und WS_EX_WINDOWEDGE.
WS_EX_PALETTEWINDOW	Verbindet die Stile WS_EX_WINDOWEDGE, WS_EX_TOOLWINDOW und WS_EX_TOPMOST.
WS_EX_RIGHT	Das Fenster hat allgemeine Eigenschaften "Rechtsbündig". Dies hängt von der Window-Klasse. Dieser Stil wirkt sich nur dann, wenn die Shell-Sprache ist Hebräisch, Arabisch oder einer anderen Sprache, die Lesevorgänge unterstützt bestellen Ausrichtung; Andernfalls ist der Stil ignoriert und nicht als Fehler behandelt.
WS_EX_RIGHTSCROLLBAR	Vertikale Bildlaufleiste (falls vorhanden) ist auf der rechten Seite des Clientbereichs. Dies ist die Standardeinstellung.
WS_EX_RTLREADING	Wenn die Shell-Sprache ist Hebräisch, Arabisch oder eine andere Sprache unterstützt lesen Reihenfolge Ausrichtung, rechts links Leserichtung Eigenschaften mithilfe der Fenstertext angezeigt wird. Für andere Sprachen der Stil ignoriert und nicht als Fehler behandelt.
WS_EX_STATICEDGE	Erstellt ein Fenster mit einem dreidimensionalen Rahmenstil für Elemente verwendet werden, die keine Benutzereingaben akzeptieren soll.
WS_EX_TOOLWINDOW	Ein Toolfenster erstellt; Das heißt, ein Fenster als unverankerte Symbolleiste verwendet werden soll. Ein Toolfenster hat eine Titelleiste, die kürzer als eine normale Titelleiste ist, und der Fenstertitel wird unter Verwendung einer kleineren Schriftart gezeichnet. Ein Fenster erscheint nicht in der Taskleiste oder im Dialogfeld, das angezeigt wird, wenn der Benutzer Alt + Tab drückt. Wenn ein Toolfenster ein Systemmenü hat, wird das Symbol nicht auf der Titelleiste angezeigt. Jedoch können Sie das System-Menü mit der rechten Maustaste oder durch Eingabe von Alt + Leertaste anzeigen.
WS_EX_TOPMOST	Gibt an, dass ein Fenster erstellt mit diesem Stil vor allem oberste Windows platziert werden soll und über ihnen, bleiben sollte, auch wenn das Fenster deaktiviert ist. Verwenden Sie zum Hinzufügen oder entfernen diesen Stil, Funktion SetWindowPos.
WS_EX_TRANSPARENT	Gibt an, dass ein Fenster erstellt mit diesem Stil nicht gezeichnet werden soll, bis der Geschwister unterhalb des Fensters (das von den gleichen Thread erstellt wurden) gemalt haben. Das Fenster wird transparent angezeigt, da die Bits der zugrunde liegenden nebengeordnete Fenster bereits gemalt haben. Um Transparenz ohne diese Einschränkungen zu erreichen, verwenden Sie die SetWindowRgn Funktion.
WS_EX_WINDOWEDGE	Gibt an, dass ein Fenster einen Rahmen mit einer erhöhten Kante hat.

Mithilfe der WS_EX_RIGHT-Stil für statische oder Edit-Steuerelemente hat den gleichen Effekt wie mit dem SS_RIGHT oder ES_RIGHT-Stil, beziehungsweise. Mit diesem Stil mit Button-Steuerelementen hat die gleiche Auswirkung wie die Verwendung von BS_RIGHT und BS_RIGHTBUTTON Stile.

lpClassName

Zeiger auf eine Null-terminierte Zeichenfolge oder eine Ganzzahl-Atom ist. Wenn LpClassName ein Atom ist, muss es eine globale Atom erstellt durch einen vorherigen Aufruf von GlobalAddAtom. 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.

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 hat eine im Fenstermenü 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 X 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. Für überlappende Fenster ist nWidth die Breite des Fensters, in Bildschirmkoordinaten oder CW_USEDEFAULT. Wenn nWidth CW_USEDEFAULT ist, wählt das System eine Standardbreite und Höhe des Fensters; die Standardbreite erstreckt sich von den ersten X-Koordinaten an den rechten Rand des Bildschirms; 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 CW_USEDEFAULT für ein Popup-Fenster oder ein untergeordnetes Fenster angegeben wird, werden der nWidth und nHeight Parameter auf 0 (null) festgelegt.

nHeight

Gibt die Höhe in Geräteeinheiten des Fensters. Für überlappende Fenster ist nHeight die Höhe des Fensters, in Bildschirmkoordinaten. Wenn der Parameter 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 einen ChildWindow Bezeichner, je nach den Fensterstil gibt. 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

Die CreateWindowEx -Funktion sendet WM_NCCREATE, WM_NCCALCSIZE und WM_CREATE Meldungen an das Fenster erstellt wird.

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.

Windows CE: Windows CE unterstützt keine Stand-alone-Menüleisten. Der hMenu -Parameter muss NULL sein, es sei denn, es als ein ChildWindow Bezeichner verwendet wird.

Windows CE-Versionen 2.0 und höher unterstützen die folgenden zwei erweiterte Fensterstile:

WS_EX_NOACTIVATE

Ein Top-Level-Fenster erstellt mit diesem Stil kann nicht aktiviert werden. Wenn ein untergeordnetes Fenster dieser Stil hat, tippen sie nicht auf oberster Ebene übergeordneten aktiviert werden verursacht. Ein Fenster, das dieses Format hat Tablettstiftereignisse erhalten, aber es weder seiner untergeordneten Fenster den Fokus erhalten können.

WS_EX_NOANIMATION

Ein Fenster mit diesem Stil erstellt animierte explodiert und implodiert Rechtecke nicht angezeigt und nicht über eine Schaltfläche auf der Taskleiste.

Die folgenden Flags DwExStyle werden nicht unterstützt.

Den Stil WS_EX_TOPMOST unterstützt Windows CE 1.0 nicht. Versionen 2.0 und höher.

Die folgenden DwStyle -Flags werden 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.

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, CreateWindow-Funktion, GlobalAddAtom, RegisterClassEx, SetWindowPos, WM_CREATE, WM_NCCALCSIZE, WM_NCCREATE, WM_PAINT, WM_PARENTNOTIFY

Index