CreateWindow

Funkcie CreateWindow vytvorí prekrytia, pop-up alebo dieťa okna. To určuje triedu okna záhlavie okna, štýl okna a (voliteľne) ustúpi a veľkosť okna. Funkcia tiež špecifikuje v okne rodič alebo vlastníka, ak existujú, a ponuke okno.

Použite rozšírenú štýly popri štýly podporované CreateWindowpoužiť funkciu CreateWindowEx namiesto pou+?itia CreateWindow.

HWND CreateWindow ( LPCTSTR  lpClassName; / / ukazovateľ registrovaný názov triedyLPCTSTRlpWindowName; / / ukazovateľ na názov oknaDWORDdwStyle; / / et2l oknaint x; / / horizontálnej polohy okna int y; / / vertikálnu polohu okna intnWidth; / / šírka okna intnHeight; / / window heightHWNDhWndParent; / / zvládnuť materskej alebo vlastník oknaHMENUhMenu; / / rukoväť na ponuku alebo dcérskym oknom identifikátorRUKOVÄŤhInstance; / / spracovávať na aplikáciu stupňaLPVOIDlpParam / / ukazovateľ na vytváranie okna údajov);
 

Parametre

lpClassName
Smerník na reťazec zakončený nulou alebo atómu celé číslo. Ak tento parameter nie je atom, musí byť globálna atóm vytvoril predchádzajúci hovor GlobalAddAtom funkciu. Atom, 16-bitová hodnota menej ako 0xC000, musí byť nízka-order slovo lpClassName; Program word Rozdeli musí byť nula.

Ak lpClassName je reťazec určuje názov okna triedy. Názov triedy môže byť ľubovoľný názov zaregistruje funkciu RegisterClassEx alebo akékoľvek Preddefinované triedy kontrola mien. Kompletný zoznam nájdete v časti poznámky.

lpWindowName
Smerník na reťazec zakončený nulou určujúci názov okna.

Ak et2l okna určuje záhlaví okna záhlavie okna poukázal na lpWindowName sa zobrazí v záhlaví okna. Pri používaní CreateWindow vytvoriť ovládacie prvky, napríklad tlačidlá, začiarkavacie políčka a statické ovládacie prvky používať lpWindowName na zadanie jej textu ovládacieho prvku.

dwStyle
Určuje štýl okna vytváraný. Tento parameter môže byť kombináciou týchto okna štýly plus štýly kontroly uvedené v časti poznámky.
Štýl Význam
WS_BORDER Vytvorí okna, ktoré obsahuje tenké čiary orámovania.
WS_CAPTION Vytvára okno, obsahujúcu záhlavie (zahŕňa WS_BORDER štýl).
WS_CHILD Vytvorí dcérskym oknom. Tento štýl sa nedá používať s WS_POPUP štýl.
WS_CHILDWINDOW Rovnako ako v WS_CHILD štýle.
WS_CLIPCHILDREN Vylučuje strany priestoru zaberaného podriadené okná, keď Kreslenie nastane v rámci rodičovské okno. Tento štýl sa používa pri vytváraní rodičovské okno.
WS_CLIPSIBLINGS Klipy podriadené okná vzťahu k sebe navzájom; keď obdrží, najmä detskej okno WM_PAINT správy, WS_CLIPSIBLINGS štýl klipy všetkých ostatných prekrývajúce podriadené okná mimo regiónu dcérskym oknom aktualizovať. Ak nie je zadaná WS_CLIPSIBLINGS a podriadené okná sa prekrývajú, je možné pri zostavovaní do klientskej oblasti dcérskym oknom čerpať do klientskej oblasti susedného dcérskym oknom.
WS_DISABLED Vytvára okno, ktoré pôvodne vypnutá. So zdravotným postihnutím okno nemôže prijímať vstup od užívateľa.
WS_DLGFRAME Vytvorí okna, ktoré obsahuje orámovanie štýl typicky sa používajú s dialógovými oknami. Okno s týmto štýlom nemôže mať záhlavie okna.
WS_GROUP Určuje prvú kontrolu skupinu ovládacích prvkov. Skupina pozostáva z tejto prvej kontroly a všetky ovládacie prvky definované po to, až na ďalší ovládací prvok s WS_GROUP štýlom. Prvé kontroly v každej skupine WS_TABSTOP štýl má obvykle tak, že používateľ môže prejsť od skupina. Používateľ môže následne zmeniť klávesnice od jeden ovládací prvok v skupine na ďalší ovládací prvok v skupine pomocou smerové klávesy.
WS_HSCROLL Vytvorí okna, ktoré obsahuje Vodorovný posúvač.
WS_ICONIC Vytvára okno, ktoré pôvodne minimalizovaná. Rovnako ako v WS_MINIMIZE štýle.
WS_MAXIMIZE Vytvorí pôvodne maximalizované okno.
WS_MAXIMIZEBOX Vytvorí okna, ktoré obsahuje tlačidlo Maximalizovať. Nemôže byť kombinovaný s WS_EX_CONTEXTHELP štýlom. WS_SYSMENU štýl sa udával tiež.
WS_MINIMIZE Vytvára okno, ktoré pôvodne minimalizovaná. Rovnako ako v WS_ICONIC štýle.
WS_MINIMIZEBOX Vytvorí okna, ktoré obsahuje tlačidlo minimalizovať. Nemôže byť kombinovaný s WS_EX_CONTEXTHELP štýlom. WS_SYSMENU štýl sa udával tiež.
WS_OVERLAPPED Vytvára okno. Okno má záhlavia a orámovania. Rovnako ako v WS_TILED štýle.
WS_OVERLAPPEDWINDOW Vytvára okno s štýly WS_OVERLAPPED, WS_CAPTION, WS_SYSMENU, WS_THICKFRAME, WS_MINIMIZEBOX a WS_MAXIMIZEBOX. Rovnako ako v WS_TILEDWINDOW štýle.
WS_POPUP Vytvorí automaticky otváraného okna. Tento štýl sa nedá používať s WS_CHILD štýl.
WS_POPUPWINDOW Vytvorí automaticky otváraného okna štýly WS_BORDER, WS_POPUP a WS_SYSMENU. Štýly WS_CAPTION a WS_POPUPWINDOW musí byť združená ponuka okno zobrazíte.
WS_SIZEBOX Vytvorí okna, ktoré obsahuje orámovanie veľkosti. Rovnako ako v WS_THICKFRAME štýle.
WS_SYSMENU Vytvára okno, v ktorom bola ponuka okno na jeho záhlavie. WS_CAPTION štýl sa udával tiež.
WS_TABSTOP Určuje ovládací prvok, ktorý môže prijímať klávesnice, keď používateľ stlačí kláves tab. Stlačením klávesu tab zmeny klávesnice na ďalší ovládací prvok s WS_TABSTOP štýlom.
WS_THICKFRAME Vytvorí okna, ktoré obsahuje orámovanie veľkosti. Rovnako ako v WS_SIZEBOX štýle.
WS_TILED Vytvára okno. Okno má záhlavia a orámovania. Rovnako ako v WS_OVERLAPPED štýle.
WS_TILEDWINDOW Vytvára okno s štýly WS_OVERLAPPED, WS_CAPTION, WS_SYSMENU, WS_THICKFRAME, WS_MINIMIZEBOX a WS_MAXIMIZEBOX. Rovnako ako v WS_OVERLAPPEDWINDOW štýle.
WS_VISIBLE Vytvorí okna, ktorá je zobrazená.
WS_VSCROLL Vytvorí okna, ktoré obsahuje Zvislý posúvač.

x
Určuje počiatočné vodorovnú polohu okna. Prekrytia alebo pop-up okno x parameter je počiatočná súradnica x v ľavom hornom rohu okna v obrazovkových súradniciach. Pre dieťa okno x je súradnica x v ľavom hornom rohu okna vzhľadom na ľavom hornom rohu oblasti rodičovské okno klienta.

Ak tento parameter nastavený na CW_USEDEFAULT, systém vyberie predvolené miesto pre prvky v okne ľavom hornom rohu a ignoruje y parameter. CW_USEDEFAULT je platný len pre prekrývajúca windows; Ak je zadaný pre automaticky otvárané okno alebo dieťa okno, x a y parametre sa nastavia na nulu.

y
Určuje počiatočné vertikálnu polohu okna. Prekrytia alebo pop-up okno y parameter je počiatočná y coordinate ľavom hornom rohu okna v obrazovkových súradniciach. Pre dieťa okno y je počiatočná y coordinate ľavom hornom rohu okna dieťa vzhľadom na ľavom hornom rohu oblasti rodičovské okno klienta. V zozname, y je počiatočná y coordinate ľavý horný roh oblasti rozbaľovacom zozname klienta vzhľadom na ľavom hornom rohu oblasti rodičovské okno klienta.

Ak okno je vytvorený s nastaveným bitom štýl WS_VISIBLE a x parameter je nastavený na CW_USEDEFAULT systéme ignoruje y parameter.

nWidth
Určuje šírku v jednotkách zariadenia okna. Prekrývajúca windows nWidth je buď window šírka v obrazovkových súradniciach alebo CW_USEDEFAULT. Ak nWidth CW_USEDEFAULT, systém vyberie a zobrazí predvolená šírka a výška okna; predvolenú šírku siaha od pôvodnej x-ová súradnica na pravý okraj obrazovky a default height siaha od pôvodného súradnicové y na začiatok oblasti ikonu. CW_USEDEFAULT je platný len pre prekrývajúca windows; Ak CW_USEDEFAULT je určený pre automaticky otvárané okno alebo dieťa okno, nWidth a nHeight sa nastavia na nulu.
nHeight
Určuje výšku v jednotkách zariadenia okna. Prekrývajúca Windows nHeight je v okne výška v obrazovkových súradniciach. Ak nWidth je nastavená na CW_USEDEFAULT, systém ignoruje nHeight.
hWndParent
Popisovač materskej alebo vlastník okna okno vytváraný. Vytvoriť dieťaťa okno alebo vlastníctve okno poskytnúť platné okno rukoväť. Tento parameter je voliteľný pre automaticky otvárané okná.

Systém Windows NT, verzia 5.0 a vyššia: Chcete vytvoriť iba na správu okien, dodávky HWND_MESSAGE alebo rukoväť na existujúcu iba na správu okien.

hMenu
Spracovať do ponuky alebo určuje identifikátor dcérskym oknom závislosti et2l okna. Prekrytia alebo pop-up okno hMenu označuje menu použiť okno; to môže byť NULL, ak menu triedy sa použije. Pre dieťa okno hMenu určuje identifikátor dcérskym oknom celočíselnú hodnotu použiť ovládací prvok dialógového poľa oznámi jeho materský podnik o udalostiach. Uplatňovanie určuje identifikátor dcérskym oknom; musí byť jedinečné pre všetky podriadené okná s rovnakým rodičovské okno.
hInstance
Rukoväť na inštanciu modulu súvisieť s oknom.
lpParam
Smerník na hodnotu do okna prešla štruktúre CREATESTRUCT zložil v parametri lParam WM_CREATE správy. Ak aplikácia hovory CreateWindow vytvoriť viaceré klientov okno rozhranie (MDI) dokumentu, lpParam musí ukazovať na CLIENTCREATESTRUCT štruktúra.

Note:

Ak funkciu podarí, vrátená hodnota je rukoväť na nové okno.

Ak funkcia zlyhá, vrátená hodnota je NULL. Získajte rozšírené informácie o chybách, volajte na číslo GetLastError.

Poznámky

Pred návratom, CreateWindow odošle správu WM_CREATE okno postupu. Pre prekrývali, pop-up a podriadené okná CreateWindow odošle správy WM_CREATE, WM_GETMINMAXINFOa WM_NCCREATE do okna. LParam parameter WM_CREATE správa obsahuje smerník na štruktúru CREATESTRUCT . Ak je zadaný štýl WS_VISIBLE, CreateWindow odošle okna všetkých správ potrebný na aktiváciu a zobraziť okno.

Informácie o kontrole, či panel úloh zobrazuje tlačidlo pre okno vytvorené nájdete Viditeľnosť tlačidlá panela úloh.

Nasledujúce preddefinované kontrolu triedy môžu byť zadané v parametri lpClassName . Poznámka zodpovedajúceho ovládacieho prvku štýlov môžete použiť v parametri dwStyle.

Trieda Význam
TLAČIDLO Označuje malé dieťa obdĺžnikové okno, ktoré predstavuje tlačidlo môže používateľ kliknúť, ak chcete zapnúť alebo vypnúť. Tlačidlové ovládače môžete použiť jednotlivo alebo v skupinách, a môžu byť označené buď alebo zobrazia bez textu. Tlačidlo kontroly zvyčajne zmeniť vzhľad, keď používateľ klikne na tlačidlo im. Ďalšie informácie nájdete v téme tlačidlá.
Pre tabuľku tlačidlo štýly, môžete zadať v parametri dwStyle zobraziť Tlačidlo štýly.
COMBOBOX Označuje kontrolné vzorky pozostávajúce z zoznamom a podobne ako ovládací prvok upraviť výber poľa. Pri použití tohto štýlu, žiadosť by zobrazenie zoznamu vždy alebo zapne bloku kvapka-down list. Ak zozname je viditeľná, zadaním znakov do poľa výber zdôrazňuje prvý zoznam políčka záznamu, ktorý sa zhoduje s zadané znaky. Naopak, výberom položky v zozname zobrazí vybratý text v poli výber. Ďalšie informácie nájdete v téme Polí so zoznamom.
Tabuľka štýly pole so zoznamom môžete zadať v parametri dwStyle nájdete v časti Rozbaľovacie pole štýlov.
UPRAVIŤ Označuje obdĺžnikové dcérskym oknom, do ktorých používateľ zadať text z klávesnice. Používateľ vyberie kontroly a dáva klávesnice kliknutím naň alebo pohybujú stlačením klávesu tab. Používateľa môžete zadať text, keď upraviť ovládací prvok zobrazuje blikajúci znak vsuvky; pomocou myši môžete presunúť kurzor, vyberte znaky nahradiť alebo umiestnite kurzor pre vloženie znakov; alebo použite kláves backspace na odstránenie znakov. Ďalšie informácie nájdete v časti Úprava kontroly.
Tabuľka upraviť kontrolu štýlov môžete zadať v parametri dwStyle nájdete v časti Upraviť kontrolu štýly.
LISTBOX Určuje zoznam znakových reťazcov. Vždy, keď sa žiadosť musí predložiť zoznam názvov, ako napríklad názvy súborov, z ktorých môžete vybrať používateľa, zadajte tento ovládací prvok. Používateľ môže zvoliť reťazec kliknutím. Vybratý reťazec je zvýraznený a hlásenia postúpené rodičovské okno. Ďalšie informácie nájdete v časti Zoznam polí.
Tabuľka rámčeku Štýly zoznamov môžete zadať v parametri dwStyle nájdete v Rámčeku Štýly zoznamov.
MDICLIENT Označuje MDI klientskeho okna. Toto okno prijíma správy, ktoré ovládajú MDI uplatňovanie podriadené okná. Odporúčané štýl bity sú WS_CLIPCHILDREN a WS_CHILD. Zadajte WS_HSCROLL a WS_VSCROLL štýlov vytvoriť MDI klienta okno, ktoré umožňuje používateľovi prejdite MDI podriadené okná do zobrazenia. Ďalšie informácie nájdete v časti Viacerých rozhraním.
RichEdit Označuje ovládací prvok Rich upraviť verzie 1.0. Toto okno umožňuje používateľovi zobraziť a upravovať text so znakom a formátovanie odseku a môže zahŕňať vložené objekty COM. Ďalšie informácie nájdete v časti Rich upraviť kontroly.
Tabuľka RTF kontrolu štýlov môžete zadať v parametri dwStyle nájdete v časti Rich upraviť kontrolu štýly.
RICHEDIT_CLASS Označuje ovládací prvok Rich upraviť verzie 2.0. Tejto kontroly umožní používateľovi zobraziť a upravovať text odseku formátovanie znakov a a môžu obsahovať vložené objekty COM. Ďalšie informácie nájdete v časti Rich upraviť kontroly.
Tabuľka RTF kontrolu štýlov môžete zadať v parametri dwStyle nájdete v časti Rich upraviť kontrolu štýly.
POSÚVAČ Označuje obdĺžnika, ktorý obsahuje posúvača a má smere šípky na oboch koncoch. Posúvač odošle hlásenie oznámenia rodičovské okno vždy, keď používateľ klikne na tlačidlo ovládacieho prvku. Rodičovské okno je zodpovedná za aktualizáciu pozícii jazdca posúvača, ak je to potrebné. Ďalšie informácie nájdete v téme Posúvače.
Tabuľky prejdite panel ovládanie štýlov môžete zadať v parametri dwStyle zobraziť Navigačné Bar kontrolu štýly.
STATICKÉ Označuje jednoduché textové pole, políčko alebo obdĺžnik použité na etikete, poľa alebo samostatné ďalšie ovládacie prvky. Statické ovládacie prvky prijať žiadne vstupy a poskytnúť žiadny výstup. Ďalšie informácie nájdete v časti Statické ovládacích prvkov.
Tabuľka statické kontrolu štýly, môžete zadať v parametri dwStyle nájdete v časti Statické kontrolu štýly.

Systém Windows 95:Systém môže podporovať maximálne 16,364 popisovače window.

Poznámkanbsp; Ak zadáte Windows verzie 4.x pri prepájaní vašej aplikácie, jeho windows nemôžete mať popis tlačidlá pokiaľ nemajú okno ponuky. &Nie sú je požiadavka, ak zadáte Windows verzia 3.x pri prepájaní vašej aplikácie.

Windows CE: CreateWindow je implementovaný ako makro. Je definovaný ako CreateWindowEx, ale s parametrom dwExStyle nastavená na 0 L.

Paneli s ponukami nie sú podporované. HMenu parameter musí byť NULL, ak sa používa ako identifikátor dcérskym oknom.

Trieda okna MDICLIENT nie je podporované.

DwStyle parameter môže byť kombináciou štýly okna a kontrolu štýly zdokumentované v:

Dialógové okná

Systém Windows

Ovládacie prvky

Nasledovné príznaky dwStyle nie sú podporované pre systém windows:

WS_CHILDWINDOW WS_ICONIC
WS_MAXIMIZE WS_MAXIMIZEBOX
WS_MINIMIZE WS_MINIMIZEBOX
WS_OVERLAPPEDWINDOW WS_POPUPWINDOW
WS_SIZEBOX WS_THICKFRAME
WS_TILED WS_TILEDWINDOW

Nasledovné príznaky dwStyle nie sú podporované na ovládacie prvky a v dialógových oknách:

Nepodporované tlačidlo štýly Nepodporovaný statické ovládací prvok štýly
BS_LEFTTEXT SS_BLACKFRAME
BS_MULTILINE SS_GRAYFRAME
BS_TEXT SS_METAPICT
BS_USERBUTTON SS_SIMPLE
Nepodporované rozbaľovacie pole štýlov SS_WHITERECT
CBS_OWNERDRAWFIXED SS_BLACKRECT
CBS_OWNERDRAWVARIABLE SS_GRAYRECT
CBS_SIMPLE SS_RIGHTIMAGE
Nepodporované zoznamu poľa kontrolu štýly SS_WHITEFRAME
LBS_NODATA Nepodporované dialógové okno pole štýlov
LBS_OWNERDRAWFIXED DS_ABSALIGN
LBS_OWNERDRAWVARIABLE DS_CENTERMOUSE
LBS_STANDARD DS_CONTEXTHELP
Nepodporované prejdite panel štýly DS_FIXEDSYS
SBS_BOTTOMALIGN DS_NOFAILCREATE
SBS_RIGHTALIGN DS_NOIDLEMSG
SBS_SIZEBOXBOTTOMRIGHTALIGN DS_SYSMODAL
SBS_SIZEGRIP

BS_OWNERDRAW štýl môžete použiť ako náhrada za BS_USERBUTTON štýl.

Môžete použiť štýl SS_LEFT alebo SS_LEFTNOWORDWRAP namiesto SS_SIMPLE štýl pre statické kontroly..

Trieda okna MDICLIENT nie je podporované.

Všetky okná implicitne mať rôzne štýly WS_CLIPSIBLINGS a WS_CLIPCHILDREN.

Systém Windows CE 1.0 nepodporuje vlastníctve windows, s výnimkou pre dialógové okná. Ak hwndParent parameter nie je NULL, okno je implicitne daný štýl WS_CHILD.

Windows CE verzia 1.0 nepodporuje ponukami.

Stručné informácie

nbsp; Systém Windows &NT: vyžaduje verzia 3.1 alebo novšia.
Windows:Vyžaduje systém Windows 95 alebo novším.
Windows CE:Vyžaduje verziu 1.0 alebo novšiu verziu.
Hlavičky:Deklarovaný v súbore winuser.h.
Importovať knižnica:Použiť user32.lib.
Unicode:Implementovaný ako Unicode, ANSI verzia v systéme Windows NT.

Pozri tiež

Windows prehľad, okno funkcie, CLIENTCREATESTRUCT, CREATESTRUCT, CreateWindowEx, GlobalAddAtom, RegisterClassEx, WM_COMMAND, WM_CREATE, WM_GETMINMAXINFO, WM_NCCREATE, WM_PAINT

Index