CreateWindowEx

De CreateWindowEx functie maakt een venster overlappende, pop-up of kind met een uitgebreide stijl; anders, deze functie is identiek aan de CreateWindow -functie. Zie voor meer informatie over het maken van een venster en voor een volledige beschrijving van de andere parameters van CreateWindowEx CreateWindow.

HWND CreateWindowEx) DWORD  dwExStyle, / / extended venster stijlLPCTSTRlpClassName, / / verwijzing naar klassenaam geregistreerdLPCTSTRlpWindowName, / / pointer naar het vensternaamDWORDdwStyle, / / venster stijl int x, / / horizontale positie van venster int y, / / verticale positie van venster intnWidth, / / vensterbreedte intnHeight, / / vensterhoogteHWNDhWndParent, / / verwerken naar bovenliggende of eigenaar vensterHMENUhMenu, / / ingang naar menu, of subvenster idHINSTANCEhInstance, / / ingang naar toepassingsexemplaarLPVOIDlpParam / / pointer naar de gegevens voor het venster aanmaken);
 

Parameters

dwExStyle

Hiermee geeft u de uitgebreide stijl van het venster. Deze parameter kan een van de volgende waarden worden:

Stijl	Betekenis
WS_EX_ACCEPTFILES	Hiermee bepaalt u dat een venster gemaakt met deze stijl drag-drop bestanden accepteert.
WS_EX_APPWINDOW	Dwingt een top-level venster op de taakbalk wanneer het venster zichtbaar is.
WS_EX_CLIENTEDGE	Hiermee geeft u aan dat een venster een grens met een verzonken rand heeft.
WS_EX_CONTEXTHELP	Omvat een vraagteken in de titelbalk van het venster. Wanneer de gebruiker klikt op het vraagteken, de cursor verandert in een vraagteken met een pointer. Als de gebruiker vervolgens op een onderliggend venster, ontvangt het kind een WM_HELP bericht. Het onderliggende venster moet de boodschap doorgeven aan de bovenliggende venster procedure, die de WinHelp -functie met behulp van de opdracht HELP_WM_HELP moet noemen. De Help-toepassing wordt weergegeven, een pop-upvenster dat meestal hulp voor het onderliggende venster bevat. WS_EX_CONTEXTHELP kan niet worden gebruikt met de stijlen van WS_MAXIMIZEBOX of WS_MINIMIZEBOX.
WS_EX_CONTROLPARENT	Hiermee kan de gebruiker de onderliggende vensters van het venster navigeren met behulp van de tab-toets.
WS_EX_DLGMODALFRAME	Hiermee maakt u een venster met een dubbele rand; het venster kan, optioneel, met een titelbalk worden gemaakt door de WS_CAPTION stijl opgeven in de parameter dwStyle.
WS_EX_LEFT	Venster heeft eigenschappen van algemene "links uitgelijnde". Dit is de standaardinstelling.
WS_EX_LEFTSCROLLBAR	Als de taal van de shell is Hebreeuws, Arabisch, of een andere taal dat ondersteunt lezen volgorde uitlijning, de verticale schuifbalk (indien aanwezig) aan de linkerkant van het clientgebied is. Voor andere talen, is de stijl genegeerd en niet als een fout aangemerkt.
WS_EX_LTRREADING	De venstertekst is weergegeven met behulp van links naar rechts-leesvolgorde eigenschappen. Dit is de standaardinstelling.
WS_EX_MDICHILD	Hiermee maakt u een MDI-subvenster.
WS_EX_NOPARENTNOTIFY	Hiermee geeft u aan dat een onderliggend venster gemaakt met deze stijl niet het bericht WM_PARENTNOTIFY naar de bovenliggende venster stuurt wanneer het wordt gemaakt of vernietigd.
WS_EX_OVERLAPPEDWINDOW	Combineert de stijlen van WS_EX_CLIENTEDGE en WS_EX_WINDOWEDGE.
WS_EX_PALETTEWINDOW	Combineert de stijlen van WS_EX_WINDOWEDGE, WS_EX_TOOLWINDOW en WS_EX_TOPMOST.
WS_EX_RIGHT	Het venster heeft algemene eigenschappen "rechts uitgelijnde". Dit is afhankelijk van de klasse van het venster. Deze stijl heeft een effect alleen als de taal van de shell is Hebreeuws, Arabisch, of een andere taal die lezing ondersteunt bestellen uitlijning; anders, de stijl is genegeerd en niet als een fout aangemerkt.
WS_EX_RIGHTSCROLLBAR	Verticale schuifbalk (indien aanwezig) is rechts van de client area. Dit is de standaardinstelling.
WS_EX_RTLREADING	Als de taal van de shell is Hebreeuws, Arabisch, of een andere taal dat ondersteunt lezen volgorde uitlijning, de venstertekst wordt weergegeven met behulp van rechts naar links-leesvolgorde eigenschappen. Voor andere talen, is de stijl genegeerd en niet als een fout aangemerkt.
WS_EX_STATICEDGE	Hiermee maakt u een venster met een driedimensionale randstijl bestemd om te worden gebruikt voor artikelen die geen invoer van de gebruiker accepteren.
WS_EX_TOOLWINDOW	Creëert een toolvenster; dat wil zeggen, bestemd een venster om te worden gebruikt als een zwevende werkbalk. Een toolvenster heeft een titelbalk die korter is dan een normale titelbalk, en de venstertitel is getekend met een kleiner lettertype. Een toolvenster verschijnt niet in de taakbalk of in het dialoogvenster dat verschijnt wanneer de gebruiker op alt + tab drukt. Als een toolvenster een systeemmenu heeft, wordt haar pictogram niet weergegeven op de titelbalk. U kunt echter het systeemmenu weergeven door rechts te klikken of door te typen alt + spatiebalk.
WS_EX_TOPMOST	Hiermee geeft u aan dat een venster gemaakt met deze stijl vooral niet-bovenste windows moet worden geplaatst en boven hen, blijven moet zelfs wanneer het venster wordt gedeactiveerd. Wilt toevoegen of verwijderen van deze stijl, gebruikt de SetWindowPos functie.
WS_EX_TRANSPARENT	Hiermee geeft u aan dat een venster gemaakt met deze stijl niet tot zijn broers en zussen onder het venster (die zijn gemaakt door dezelfde thread) geschilderd moet worden geschilderd. Het venster verschijnt transparant omdat de bits van de onderliggende element van gelijk niveau windows zijn al geschilderd. Om dat te bereiken transparantie zonder deze beperkingen, de SetWindowRgn -functie.
WS_EX_WINDOWEDGE	Hiermee geeft u aan dat een venster een grens met een verhoogde rand heeft.

Met behulp van de WS_EX_RIGHT stijl voor statische of besturingselementen bewerken heeft hetzelfde effect als met de SS_RIGHT of ES_RIGHT stijl, respectievelijk. Met behulp van deze stijl met button-besturingselementen heeft hetzelfde effect als het gebruik van stijlen van BS_RIGHT en BS_RIGHTBUTTON.

lpClassName

Pointer naar een op null eindigende tekenreeks of een integer atoom. Als lpClassName een atoom is, het moet een globale atoom gemaakt door een eerdere aanroep van GlobalAddAtom. Het Atoom, een 16-bits waarde lager is dan 0xC000, moet worden in de lage-orde woord van lpClassName; de eersterangs woord moet nul zijn.

Als lpClassName een tekenreeks is, geeft het naam van de klasse van het venster. Naam van de klasse kan een willekeurige naam geregistreerd met de functie RegisterClassEx of een van de vooraf gedefinieerde controle-klasse namen worden.

lpWindowName

Pointer naar een op null eindigende tekenreeks waarmee de naam van het venster.

Als het venster opmaakprofiel een titelbalk bepaalt, wordt de titel van het venster waarnaar wordt verwezen door lpWindowName weergegeven in de titelbalk. Wanneer u CreateWindow maken van besturingselementen, zoals knoppen, selectievakjes en statische besturingselementen, gebruiken lpWindowName de tekst van het besturingselement opgeven.

dwStyle

Geeft de stijl van het venster wordt gemaakt. Deze parameter kan bestaan uit een combinatie van de volgende venster stijlen, plus de controle stijlen aangegeven in de sectie opmerkingen.

Stijl	Betekenis
WS_BORDER	Hiermee maakt u een venster met een dun-lijn-rand.
WS_CAPTION	Hiermee maakt u een venster dat een titelbalk heeft (inclusief de WS_BORDER-stijl).
WS_CHILD	Hiermee maakt u een onderliggend venster. Deze stijl kan niet worden gebruikt met de stijl WS_POPUP.
WS_CHILDWINDOW	Hetzelfde als de WS_CHILD stijl.
WS_CLIPCHILDREN	Sluit de ruimte bezet door kind windows als tekening binnen het bovenliggende venster optreedt. Deze stijl wordt gebruikt bij het maken van het bovenliggende venster.
WS_CLIPSIBLINGS	Clips kind windows relatief ten opzichte van elkaar; dat wil zeggen, wanneer een bepaald onderliggend venster ontvangt een WM_PAINT -bericht, de WS_CLIPSIBLINGS stijl clips alle andere overlappende vensters kind uit de regio van het onderliggende venster worden bijgewerkt. Als WS_CLIPSIBLINGS niet is opgegeven en onderliggende vensters overlappen, is het mogelijk, bij het tekenen in het clientgebied van een onderliggend venster, om te tekenen in het clientgebied van een naburige onderliggend venster.
WS_DISABLED	Hiermee maakt u een venster dat is in eerste instantie uitgeschakeld. Een handicap venster ontvangen geen input van de gebruiker.
WS_DLGFRAME	Hiermee maakt u een venster met een rand van een stijl die meestal gebruikt met dialoogvensters. Een venster met deze stijl kan niet hebben een titelbalk.
WS_GROUP	Hiermee geeft u het eerste besturingselement van een groep besturingselementen. De groep bestaat uit deze eerste besturingselement en alle besturingselementen gedefinieerd na, tot aan het volgende besturingselement met de WS_GROUP stijl. Meestal heeft het eerste besturingselement in elke groep de WS_TABSTOP stijl zodat de gebruiker van groep naar groep verplaatsen kan. De gebruiker kan vervolgens wijzigen de toetsenbordfocus van het ene besturingselement in de groep naar het volgende besturingselement in de groep met behulp van de pijltjestoetsen.
WS_HSCROLL	Hiermee maakt u een venster met een horizontale schuifbalk.
WS_ICONIC	Hiermee maakt u een venster dat in eerste instantie is geminimaliseerd. Hetzelfde als de WS_MINIMIZE stijl.
WS_MAXIMIZE	Hiermee maakt u een venster dat in eerste instantie is gemaximaliseerd.
WS_MAXIMIZEBOX	Hiermee maakt u een venster waarin de knop maximaliseren. Kan niet worden gecombineerd met de WS_EX_CONTEXTHELP stijl. De stijl WS_SYSMENU moet ook worden opgegeven.
WS_MINIMIZE	Hiermee maakt u een venster dat in eerste instantie is geminimaliseerd. Hetzelfde als de WS_ICONIC stijl.
WS_MINIMIZEBOX	Hiermee maakt u een venster waarin de knop minimaliseren. Kan niet worden gecombineerd met de WS_EX_CONTEXTHELP stijl. De stijl WS_SYSMENU moet ook worden opgegeven.
WS_OVERLAPPED	Hiermee maakt u een overlappende venster. Een overlappende venster heeft een titelbalk en een rand. Hetzelfde als de WS_TILED stijl.
WS_OVERLAPPEDWINDOW	Hiermee maakt u een overlappende venster met de stijlen van WS_OVERLAPPED, WS_CAPTION, WS_SYSMENU, WS_THICKFRAME, WS_MINIMIZEBOX en WS_MAXIMIZEBOX. Hetzelfde als de WS_TILEDWINDOW stijl.
WS_POPUP	Hiermee maakt u een pop-upvenster. Deze stijl kan niet worden gebruikt met de stijl WS_CHILD.
WS_POPUPWINDOW	Hiermee maakt u een pop-upvenster met WS_BORDER, WS_POPUP en WS_SYSMENU stijlen. De WS_CAPTION en WS_POPUPWINDOW stijlen moeten worden gecombineerd om zichtbaar te maken het venstermenu.
WS_SIZEBOX	Wordt een venster met een grootte rand gemaakt. Hetzelfde als de WS_THICKFRAME stijl.
WS_SYSMENU	Hiermee maakt u een venster met een venstermenu op de titelbalk. De stijl van de WS_CAPTION moet ook worden opgegeven.
WS_TABSTOP	Hiermee geeft u een besturingselement dat de focus van het toetsenbord ontvangen kunt wanneer de gebruiker op de tab-toets drukt. Op de tab-toets te drukken wijzigt de toetsenbordfocus naar het volgende besturingselement met de WS_TABSTOP stijl.
WS_THICKFRAME	Wordt een venster met een grootte rand gemaakt. Hetzelfde als de WS_SIZEBOX stijl.
WS_TILED	Hiermee maakt u een overlappende venster. Een overlappende venster heeft een titelbalk en een rand. Hetzelfde als de WS_OVERLAPPED stijl.
WS_TILEDWINDOW	Hiermee maakt u een overlappende venster met de stijlen van WS_OVERLAPPED, WS_CAPTION, WS_SYSMENU, WS_THICKFRAME, WS_MINIMIZEBOX en WS_MAXIMIZEBOX. Hetzelfde als de WS_OVERLAPPEDWINDOW stijl.
WS_VISIBLE	Hiermee maakt u een venster dat in eerste instantie zichtbaar is.
WS_VSCROLL	Hiermee maakt u een venster met een verticale schuifbalk.

x

Hiermee geeft u de eerste horizontale positie van het venster. Voor een overlappende of pop-up venster is de parameter x de eerste x-coördinaat van het venster de upper-left hoek, in de schermcoördinaten. Voor een onderliggend venster is x de x-coördinaat van de linkerbovenhoek van het venster relatief ten opzichte van de linkerbovenhoek van het clientgebied van het bovenliggende venster.

Als x is ingesteld op CW_USEDEFAULT, het systeem selecteert de standaardpositie voor de linkerbovenhoek van het venster en gaat voorbij aan de parameter y . CW_USEDEFAULT is alleen geldig voor overlappende vensters; Als dit is opgegeven voor zijn een pop-up of kind venster, de x - en y -parameters ingesteld op nul.

y

Hiermee geeft u de eerste verticale positie van het venster. Voor een overlappende of pop-up venster is de parameter y de eerste y-coördinaat van het venster de upper-left hoek, in de schermcoördinaten. Voor een onderliggend venster is y de eerste y-coördinaat van de upper-left hoek van het onderliggende venster relatief ten opzichte van de linkerbovenhoek van het clientgebied van het bovenliggende venster. Voor een keuzelijst is y de eerste y-coördinaat van de linkerbovenhoek van de keuzelijst in clientgebied relatief ten opzichte van de linkerbovenhoek van het clientgebied van het bovenliggende venster.

Als een overlappende venster is gemaakt met de WS_VISIBLE stijl bit is ingesteld en de x -parameter is ingesteld op CW_USEDEFAULT, negeert het systeem de parameter y.

nWidth

De breedte, in eenheden van apparaat van het venster. Voor overlappende windows is nWidth de breedte van het venster, in schermcoördinaten, of CW_USEDEFAULT. Als nWidth CW_USEDEFAULT is, selecteert het systeem een standaardbreedte en hoogte van het venster; de standaardbreedte strekt zich uit van de eerste x-coördinaten aan de rechterkant van het scherm; de standaardhoogte strekt zich uit van de aanvankelijke y-coördinaat naar de top van het pictogram gebied. CW_USEDEFAULT is alleen geldig voor overlappende vensters; Als CW_USEDEFAULT is opgegeven voor een venster pop-up of kind, de parameter nWidth en nHeight zijn ingesteld op nul.

nHeight

Hiermee geeft u de hoogte, in eenheden van apparaat van het venster. Voor overlappende windows is nHeight de hoogte van het venster, in de schermcoördinaten. Als de parameter nWidth is ingesteld op CW_USEDEFAULT, negeert het systeem nHeight.

hWndParent

Ingang naar het venster van het bovenliggende of eigenaar van het venster wordt gemaakt. Als u een onderliggend venster of een eigendom venster, leveren een geldige vensteringang. Deze parameter is optioneel voor pop-upvensters.

Windows NT 5.0 en hoger: Een alleen-bericht venster maken, leveren HWND_MESSAGE of een ingang voor een bestaande alleen-bericht venster.

hMenu

Ingang naar een menu, of Hiermee geeft u de id van een kind-venster, afhankelijk van de stijl van het venster. Voor een overlappende of pop-up venster identificeert hMenu het menu om te worden gebruikt met het venster; het kan worden NULL als het menu klasse wordt gebruikt. Voor een onderliggend venster geeft hMenu de kind-venster identificatie, een integer-waarde gebruikt door een besturingselement voor een dialoogvenster in kennis te stellen van de bovenliggende over gebeurtenissen. De toepassing bepaalt het subvenster identifier; Deze moet uniek zijn voor alle onderliggende vensters met hetzelfde bovenliggende venster.

hInstance

Ingang naar instantie van de module te worden gekoppeld aan het venster.

lpParam

Een aanwijzer naar een waarde die moet worden doorgegeven aan het venster door de CREATESTRUCT structuur doorgegeven in de parameter lParam het WM_CREATE bericht. Als een toepassing oproepen CreateWindow maken een meerdere documentvenster interface (MDI) client, moet lpParam verwijzen naar een structuur van CLIENTCREATESTRUCT.

Retourwaarden

Als de functie slaagt, is de retourwaarde een ingang voor het nieuwe venster.

Als de functie mislukt, is de retourwaarde NULL. Te krijgen uitgebreide foutinformatie, Bel GetLastError.

Opmerkingen

De functie CreateWindowEx verzonden WM_NCCREATE, WM_NCCALCSIZE en WM_CREATE berichten naar het venster wordt gemaakt.

Zie voor informatie over het controleren of de taakbalk een knop voor de gemaakte venster worden weergegeven, Zichtbaarheid van taakbalkknoppen.

De volgende vooraf gedefinieerde controle klassen kunnen worden opgegeven in de parameter lpClassName . Opmerking dat het bijbehorende besturingselement stijlen u kunt gebruiken in de parameter dwStyle.

Windows 95: Het systeem kan een maximum van 16,364 venster grepen ondersteunen.

Windows CE: Windows CE ondersteunt geen stand-alone menubalken. De parameter hMenu moet NULL, tenzij het is gebruikt als de id van een kind-venster.

Windows CE versie 2.0 en hoger ondersteunt de volgende twee stijlen van het uitgebreide venster:

WS_EX_NOACTIVATE

Een venster van de hoogste niveau gemaakt met deze stijl kan niet worden geactiveerd. Als een onderliggend venster deze stijl heeft, zal te tikken op het geen haar op het hoogste niveau bovenliggende worden geactiveerd. Een venster met deze stijl ontvangt de naald gebeurtenissen, maar het noch haar kind windows kunnen de focus krijgen.

WS_EX_NOANIMATION

Een venster gemaakt met deze stijl toont niet geanimeerde exploderende en rechthoeken implodeert, en hoeft niet een knop op de taakbalk.

De volgende dwExStyle vlaggen worden niet ondersteund.

Windows CE 1.0 biedt geen ondersteuning voor de WS_EX_TOPMOST stijl. Versies 2.0 en hoger doen.

De volgende dwStyle vlaggen worden niet ondersteund.

Alle vensters hebben impliciet de stijlen van WS_CLIPSIBLINGS en WS_CLIPCHILDREN.

Windows CE 1.0 ondersteunt geen eigendom windows, behalve voor dialoogvensters. Als de parameter hwndParent niet NULL is, wordt het venster de WS_CHILD stijl impliciet gegeven.

Syntaxisinfo

nbsp; Windows &NT: versie 3.1 of hoger vereist.
Windows:Windows 95 of hoger vereist.
Windows CE:Versie 1.0 of hoger vereist.
Header:Verklaard in winuser.h.
Bibliotheek importeren:User32.lib gebruiken.
Unicode:Geïmplementeerd als Unicode en ANSI-versies van Windows NT.

Zie ook

Windows-overzicht, venster functioneert, CLIENTCREATESTRUCT, CREATESTRUCT, CreateWindow, GlobalAddAtom, RegisterClassEx, SetWindowPos, WM_CREATE, WM_NCCALCSIZE, WM_NCCREATE, WM_PAINT, WM_PARENTNOTIFY

Index