CreateWindow

Funcţia CreateWindow creează o fereastră suprapus, pop-up sau copil. Specifică clasa fereastra, fereastra titlul, stil fereastra, şi (opţional) pozi?ia ini?ială ?i dimensiunea ferestrei. Funcţia specifică, de asemenea, fereastra de mamă sau proprietar, dacă este cazul, şi meniu a ferestrei.

Pentru a utiliza stiluri extins în plus faţă de stiluri susţinută de CreateWindow, utilizaţi funcţia CreateWindowEx în loc de utilizarea CreateWindow.

(HWND CreateWindow LPCTSTR  lpClassName, / / indicatorul pentru a înregistrat numele claseiLPCTSTRlpWindowName, / / indicatorul la numele ferestreiDWORDdwStyle, / / stil fereastraint x, / / orizontală poziţia ferestrei int y, / / verticală poziţia ferestrei intnWidth, / / lăţime fereastră intnHeight, / / înălţime fereastrăHWNDhWndParent, / / ocupa fereastra părinte sau proprietarulHMENUhMenu, / / ocupa de meniu sau copil-fereastra identificatorMÂNERhInstance, / / ocupa de instanta applicationLPVOIDlpParam / / cursorul în fereastra Creare date);
 

Parametrii

lpClassName

Indicatorul la un şir null-terminated sau este un atom întreg. Dacă acest parametru este un atom, trebuie să fie un atom global created by un apel anterioare la GlobalAddAtom funcţie. Atom, o valoare de 16 biţi mai mică de 0xC000, trebuie să fie în cuvântul low-ordine lpClassName; cuvântul de înaltă-comandă trebuie să fie zero.

În cazul în care lpClassName este un şir, specifică numele de clasa fereastra. Numele de clasă poate fi orice nume înregistrat cu funcţia RegisterClassEx sau orice nume control-clasa predefinite. Pentru o listă completă, consultaţi secţiunea observaţii.

lpWindowName

Indicatorul un şir null-terminated care specifică numele ferestrei.

Dacă stilul fereastra specifică o bară de titlu, titlul ferestrei a subliniat de lpWindowName este afişat în bara de titlu. Atunci când se utilizează CreateWindow pentru a crea controale, cum ar fi butoane, casete de selectare şi controale statică, utilizaţi lpWindowName pentru a specifica textul din control.

dwStyle

Specifică stilul de fereastra fiind creat. Acest parametru poate fi o combinaţie de următoarele stiluri fereastra, plus stilurile control indicate în secţiunea observaţii.

Stil	Sensul
WS_BORDER	Creează o fereastră care are o linie subţire bordură.
WS_CAPTION	Creează o fereastră care are o bară de titlu (include stilul WS_BORDER).
WS_CHILD	Creează o fereastră de copil. Acest stil nu poate fi utilizat cu stilul de WS_POPUP.
WS_CHILDWINDOW	Fel ca stilul de WS_CHILD.
WS_CLIPCHILDREN	Exclude suprafaţa ocupată de copil windows atunci când desen apare în fereastra părinte. Acest stil este utilizată la crearea fereastra părinte.
WS_CLIPSIBLINGS	Clipuri copil windows relativ la celălalt; Asta este, atunci când o fereastra copil special primeşte un WM_PAINT mesaj, stilul WS_CLIPSIBLINGS clipuri tuturor celorlalte suprapuse copil ferestre din regiunea fereastra copil să fie actualizate. Dacă WS_CLIPSIBLINGS nu este specificat şi copil windows se suprapun, este posibil, atunci când o fereastră de copil, pentru a desena în interiorul zonei de client de o fereastra copil vecine în zona client.
WS_DISABLED	Creează o fereastră care iniţial este dezactivat. O fereastră cu handicap pot primi de intrare de la utilizator.
WS_DLGFRAME	Creează o fereastră care are o frontieră de stil utilizează de obicei cu casetele de dialog. O fereastră cu acest stil nu au o bară de titlu.
WS_GROUP	Specifică primul control dintr-un grup de controale. Grupul este format din acest primul control şi toate controalele definite după ce, până la controlul următoare cu stilul WS_GROUP. Comanda prima în fiecare grup de obicei, are stilul WS_TABSTOP astfel încât utilizatorul poate muta din grup. Utilizatorul poate ulterior schimba focalizarea tastaturii la un control din grup la controlul următoare în grupul utilizând tastele de direcţie.
WS_HSCROLL	Creează o fereastră care are o bară de defilare orizontală.
WS_ICONIC	Creează o fereastră care iniţial este minimizat. Fel ca stilul de WS_MINIMIZE.
WS_MAXIMIZE	Creează o fereastră care iniţial este maximizată.
WS_MAXIMIZEBOX	Creează o fereastră care are un buton de maximizare. Nu pot fi combinate cu stilul WS_EX_CONTEXTHELP. WS_SYSMENU stilul trebuie să fie de asemenea precizate.
WS_MINIMIZE	Creează o fereastră care iniţial este minimizat. Fel ca stilul de WS_ICONIC.
WS_MINIMIZEBOX	Creează o fereastră care are un buton de Minimizare. Nu pot fi combinate cu stilul WS_EX_CONTEXTHELP. WS_SYSMENU stilul trebuie să fie de asemenea precizate.
WS_OVERLAPPED	Creează o fereastră suprapuse. O fereastră suprapus are o bară de titlu şi un chenar. Fel ca stilul de WS_TILED.
WS_OVERLAPPEDWINDOW	Creează o fereastră suprapus cu stiluri WS_OVERLAPPED, WS_CAPTION, WS_SYSMENU, WS_THICKFRAME, WS_MINIMIZEBOX şi WS_MAXIMIZEBOX. Fel ca stilul de WS_TILEDWINDOW.
WS_POPUP	Creează o fereastră pop-up. Acest stil nu poate fi utilizat cu stilul de WS_CHILD.
WS_POPUPWINDOW	Creează o fereastră pop-up cu stiluri WS_BORDER, WS_POPUP şi WS_SYSMENU. Stiluri WS_CAPTION şi WS_POPUPWINDOW trebuie să fie combinate pentru a face vizibile din meniul Fereastră.
WS_SIZEBOX	Creează o fereastră care are o frontieră de dimensionare. Fel ca stilul de WS_THICKFRAME.
WS_SYSMENU	Creează o fereastră care are o fereastră-meniu în bara sa de titlu. Stilul de WS_CAPTION, de asemenea, trebuie să fie specificate.
WS_TABSTOP	Specifică un control care poate primi focalizarea tastaturii atunci când utilizatorul apasă tasta tab. Apăsând tasta tab se modifică focalizarea tastaturii la controlul următoare cu stilul WS_TABSTOP.
WS_THICKFRAME	Creează o fereastră care are o frontieră de dimensionare. Fel ca stilul de WS_SIZEBOX.
WS_TILED	Creează o fereastră suprapuse. O fereastră suprapus are o bară de titlu şi un chenar. Fel ca stilul de WS_OVERLAPPED.
WS_TILEDWINDOW	Creează o fereastră suprapus cu stiluri WS_OVERLAPPED, WS_CAPTION, WS_SYSMENU, WS_THICKFRAME, WS_MINIMIZEBOX şi WS_MAXIMIZEBOX. Fel ca stilul de WS_OVERLAPPEDWINDOW.
WS_VISIBLE	Creează o fereastră care este iniţial vizibil.
WS_VSCROLL	Creează o fereastră care are o bară de defilare verticală.

x

Specifică pozi?ia orizontală ini?ială a ferestrei. Pentru o fereastră pop-up sau suprapus, parametrul x este coordonata x ini?ială din colţul de stânga a ferestrei, în ecran coordonate. Pentru o fereastră de copil, x este coordonata x din colţul din stânga-sus al ferestrei relativ la colţul din stânga-sus din fereastra părinte client zona.

Dacă acest parametru este setat la CW_USEDEFAULT, sistemul selectează poziţia implicită pentru colţul din stânga a ferestrei şi ignoră parametrul y . CW_USEDEFAULT este valabilă numai pentru windows suprapus; dacă acesta este specificat pentru un pop-up sau copil fereastra, x şi y parametri sunt setate la zero.

y

Specifică pozi?ia verticală iniţială a ferestrei. Pentru o fereastră pop-up sau suprapus, parametrul y este coordonata y ini?ială din colţul de stânga a ferestrei, în ecran coordonate. Pentru o fereastră de copil, y este coordonata y ini?ială din colţul stânga sus a ferestrei copil relativ la colţul din stânga-sus din fereastra părinte client zona. Pentru o casetă listă, y este coordonata y ini?ială din colţul stânga-sus din caseta listă client zona relativ la colţul din stânga-sus din fereastra părinte client zona.

Dacă o fereastră suprapus este creat cu stil WS_VISIBLE bit set şi parametrul x este setat la CW_USEDEFAULT, sistemul ignoră parametrul y.

nWidth

Specifică lăţimea, în unită?i de dispozitiv, a ferestrei. Pentru Ferestre suprapuse, nWidth este fie fereastra de lăţimea, în ecran coordonate, sau CW_USEDEFAULT. În cazul în care nWidth este CW_USEDEFAULT, sistemul selectează implicit lăţimea şi înălţimea pentru fereastra; lăţimea implicită se extinde la iniţială coordonata x la marginea din dreapta a ecranului, şi înălţimea implicită se extinde de la iniţială coordonata y în partea de sus a zonei de icon. CW_USEDEFAULT este valabilă numai pentru windows suprapus; în cazul în care CW_USEDEFAULT este specificată pentru o fereastră pop-up sau copil, nWidth şi nHeight sunt setate la zero.

nHeight

Specifică înălţimea, în unită?i de dispozitiv, a ferestrei. Pentru Ferestre suprapuse, nHeight este înălţimea a ferestrei, în ecran coordonate. În cazul în care nWidth este setat la CW_USEDEFAULT, sistemul ignoră nHeight.

hWndParent

Ocupa în fereastra părinte sau proprietarul a ferestrei fiind creat. Pentru a crea o fereastra copil sau o fereastră de proprietate, furnizează un mâner fereastra valabil. Acest parametru este facultativă pentru ferestre pop-up.

Windows NT 5.0 şi mai târziu: Pentru a crea o fereastră de mesaj-doar, de aprovizionare HWND_MESSAGE sau un ghidaj de la o fereastră de mesaj-numai existente.

hMenu

Ocupa la un meniu sau un copil-fereastra identificatorul în funcţie de stilul de fereastra. Pentru o fereastră pop-up sau suprapus, hMenu identifică meniul pentru a fi utilizate cu fereastra; Acesta poate fi NULL dacă meniul clasa este de a fi utilizate. Pentru o fereastră de copil, hMenu specifică identificatorul copil-fereastra, o valoare de tip întreg utilizate de un control casetă de dialog să notifice mamă despre evenimente. Aplicarea determină identificatorul fereastra copil; trebuie să fie unic pentru toate ferestrele de copil cu aceeaşi fereastră părinte.

hInstance

Mâner instanţă modulului să fie asociate cu fereastra.

lpParam

Un indicator spre o valoare pentru a fi trecut la fereastra prin structura CREATESTRUCT trecut în parametrul lParam mesaj WM_CREATE . Dacă o cerere apeluri CreateWindow pentru a crea un multiple document interface (MDI) fereastra client, lpParam trebuie să indicaţi spre o structură CLIENTCREATESTRUCT.

Valorile întroarse

Dacă funcţia reuşeşte, valoarea returnată este un mâner în fereastra nouă.

Dacă funcţia nu reuşeşte, valoarea returnată este NULL. Pentru a obţine extins informa?ii eroare, apel GetLastError.

Observaţii

Înainte de a reveni, CreateWindow a trimite un mesaj WM_CREATE pentru procedura fereastra. Pentru suprapus, pop-up şi copil windows, CreateWindow trimite mesaje WM_CREATE, WM_GETMINMAXINFOşi WM_NCCREATE la fereastra. Parametrul lParam WM_CREATE mesajului conţine un indicator spre o structură CREATESTRUCT . Dacă stilul WS_VISIBLE este specificat, CreateWindow trimite fereastra toate mesajele necesare pentru a activa şi afişează fereastra.

Pentru informaţii despre controlul dacă bara de activită?i afişează un buton pentru fereastra create, consultaţi Vizibilitatea butoane din bara de activită?i.

Următoarele clase predefinite de control poate fi specificat în parametrul lpClassName . Notă controlului corespondent stiluri se pot utiliza în parametrul dwStyle.

Windows 95:Sistemul poate suporta un maxim de 16,364 fereastra mânere.

&Notănbsp; Dacă specificaţi Windows versiunea 4.x când legaţi aplicaţia, sa windows nu au butoane legendă excepţia cazului în care acestea au, de asemenea, fereastra meniuri. Acest lucru nu este o cerinţă, dacă specificaţi Windows 3.x versiune când legaţi aplicaţia.

Windows CE: CreateWindow este implementat ca o macrocomandă. Acesta este definit ca CreateWindowEx, dar cu parametrul dwExStyle setată la 0 L.

Barele de meniu nu sunt acceptate. Parametrul hMenu trebuie să fie nul, dacă este utilizat ca un copil-fereastra identificator.

Clasa MDICLIENT fereastra nu este acceptat.

Parametrul dwStyle poate fi o combinaţie de stiluri fereastră şi stiluri de control documentate în:

Casetele de dialog

Windows

Controale

Următoarele steagurile dwStyle nu sunt acceptate pentru windows:

Următoarele steagurile dwStyle nu sunt acceptate pentru controale şi casetele de dialog:

Aveţi posibilitatea să utilizaţi stilul BS_OWNERDRAW ca un substitut pentru stilul de BS_USERBUTTON.

Aveţi posibilitatea să utilizaţi stilul SS_LEFT sau SS_LEFTNOWORDWRAP în loc de stilul SS_SIMPLE pentru controale statice..

Clasa MDICLIENT fereastra nu este acceptat.

Toate ferestrele implicit au stiluri de WS_CLIPSIBLINGS şi WS_CLIPCHILDREN.

Windows CE 1.0 nu acceptă proprietatea windows, cu excepţia pentru casete de dialog. Dacă parametrul hwndParent nu este nul, fereastra implicit va fi stilul WS_CHILD.

Windows CE versiunea 1.0 acceptă bare de meniuri.

QuickInfo

nbsp; Windows &NT: necesită versiunea 3.1 sau mai târziu.
Windows:Necesită Windows 95 sau o versiune ulterioară.
Windows CE:Necesită versiunea 1.0 sau mai târziu.
Antet:A declarat în winuser.h.
Import Biblioteca:Utilizarea user32.lib.
Unicode:Pus în aplicare ca Unicode şi ANSI versiuni Windows NT.

A se vedea, de asemenea

Prezentare generală a Windows, fereastra Funcţii, CLIENTCREATESTRUCT, CREATESTRUCT, CreateWindowEx, , GlobalAddAtom, RegisterClassEx, WM_COMMAND, WM_CREATE, WM_GETMINMAXINFO, WM_NCCREATE, WM_PAINT

Index