CreateWindowEx

CreateWindowEx işlevi, genişletilmiş bir stil ile örtüşen, pop-up veya alt pencere oluşturur; Aksi takdirde, bu işlev Cw_usedefault işlevi için aynıdır. Pencere oluşturma hakkında daha fazla bilgi ve CreateWindowExdiğer parametreleri tam açıklamaları için bkz: Cw_usedefault.

hwnd CreateWindowEx) dword  dwExStyle, / / genişletilmiş pencere stililpctstrlpClassName, / / işaretçisine kayıtlı sınıf adılpctstrlpWindowName, / / pencere adı işaretçisinedworddwStyle, / / pencere stili int x, / / yatay penceresinin konumunu int y, / / dikey penceresinin konumunu intnWidth, / / pencere genişliği intnHeight, / / pencere yüksekliğihwndhWndParent, / / kolu üst veya sahibi pencereyeHMENU'nunHMENU'nun, / / idare menü ya da alt-pencere tanıtıcısıHINSTANCEHINSTANCE, / / işlemek için uygulama örneğiLPVOIDlpParam / / pencere oluşturma veri işaretçisi);
 

Parametreleri

dwExStyle

Pencere genişletilmiş stilini belirtir. Bu parametre aşağıdaki değerlerden biri olabilir:

Stil	Anlamı
WS_EX_ACCEPTFILES	Bu stili ile oluşturulan bir pencereyi sürükle bırak dosya kabul ettiğini belirtir.
WS_EX_APPWINDOW	Pencere görünür olduğunda görev üzerine üst düzey bir pencere zorlar.
WS_EX_CLIENTEDGE	Bir pencere kenarlık ile batık bir kenar sahip olduğunu belirtir.
WS_EX_CONTEXTHELP	Pencerenin başlık çubuğunda soru işareti içerir. Soru işareti, bir işaretçi bir soru işareti imlecini değişiklikler kullanıcı tıkladığında. Kullanıcı tıklattığında alt pencere, çocuk bir wm_help iletisi alır. Alt pencereyi mesajı help_wm_help komutunu kullanarak WinHelp işlevini çağırmalıdır üst pencere yordamı için geçirmesi gerekir. Yardım uygulama genellikle alt pencere Yardımı içeren bir pencere görüntüler. Ws_ex_contexthelp WS_MAXIMIZEBOX ya da WS_MINIMIZEBOX stilleri ile kullanılamaz.
WS_EX_CONTROLPARENT	Kullanıcının SEKME tuşunu kullanarak pencerenin alt pencereleri arasında gezinme.
WS_EX_DLGMODALFRAME	Çift kenarlık vardır bir pencere oluşturur; pencere isteğe bağlı olarak, başlık çubuğu ile dwStyle parametresi WS_CAPTION stili belirterek oluşturulabilir.
WS_EX_LEFT	Penceresinde "sola hizalı" genel özellikleri vardır. Varsayılan.
WS_EX_LEFTSCROLLBAR	Kabuk dili, İbranice, Arapça ya da başka bir dilde, sipariş hizalama okuma destekler, dikey kaydırma çubuğunun altında (varsa) istemci alanının solunda olduğunu ise. Diğer diller için stil yok sayılır ve hata olarak tedavi değil.
WS_EX_LTRREADING	Pencere metin okuma sırasını özelliklerini sağa sola kullanarak görüntülenir. Varsayılan.
WS_EX_MDICHILD	Bir MDI alt penceresi oluşturur.
WS_EX_NOPARENTNOTIFY	Oluşturulduğunda veya tahrip bu stili ile oluşturulan alt pencere WM_PARENTNOTIFY kendi ana penceresine göndermek değil olduğunu belirtir.
WS_EX_OVERLAPPEDWINDOW	WS_EX_CLIENTEDGE ve WS_EX_WINDOWEDGE stilleri birleştirir.
WS_EX_PALETTEWINDOW	WS_EX_WINDOWEDGE, WS_EX_TOOLWINDOW ve ws_ex_topmost stilleri birleştirir.
WS_EX_RIGHT	Penceresinde "sağa hizalanmış" genel özellikleri vardır. Bu pencere sınıfını bağlıdır. Kabuk dili, İbranice, Arapça ya da okuma destekleyen başka bir dil ise bu tarz bir etkisi vardır sipariş hizalama; Aksi takdirde stili yok sayılır ve hata olarak tedavi değil.
WS_EX_RIGHTSCROLLBAR	Dikey kaydırma çubuğu (varsa) istemci alanının sağında olan. Varsayılan.
WS_EX_RTLREADING	Eğer kabuk dili İbranice, Arapça ya da başka bir dilde, sağdan sola okuma sırası özelliklerini kullanarak sipariş hizalama okuma destekler, pencere metin görüntülenir. Diğer diller için stil yok sayılır ve hata olarak tedavi değil.
WS_EX_STATICEDGE	Kullanıcı girişi kabul etmez maddelerin kullanılması hedeflenen üç boyutlu kenarlık stili ile bir pencere oluşturur.
WS_EX_TOOLWINDOW	Bir araç penceresi oluşturur; başka bir deyişle, bir pencere kayan bir araç kullanılması amaçlanmıştır. Bir araç penceresi normal başlık çubuğu kısa başlık çubuğu vardır ve pencere başlığını daha küçük bir yazı tipi kullanılarak çizilir. Bir araç penceresi, vazife ya da kullanıcı alt + sekme tuşuna bastığında, görüntülenen iletişim kutusunda görünmez. Bir araç penceresi bir sistem menüsü varsa, başlık çubuğunda simgesi görüntülenmez. Ancak, sağ tıklatarak veya alt + boşluk yazarak sistem menüsünü görüntüleyebilirsiniz.
WS_EX_TOPMOST	Bu stili ile oluşturulan bir pencere her şeyden olmayan üstteki windows yerleştirilmelidir ve hatta pencere devre dışı bırakıldığında, onları kalmak gerekir belirtir. Bu stili Ekle/Kaldır için SetWindowPos işlevini kullanın.
WS_EX_TRANSPARENT	Pencerenin altındaki kardeşleri (, aynı iş parçacığı tarafından oluşturulan) boyalı kadar bu stili ile oluşturulan bir pencere boyanması değil olduğunu belirtir. Alttaki kardeş windows bit zaten boyalı çünkü pencere saydam görünür. Şeffaflık bu kısıtlama olmadan elde etmek için kullanın SetWindowRgn işlevi.
WS_EX_WINDOWEDGE	Bir pencere kenarlık ile yükseltilmiş bir kenar sahip olduğunu belirtir.

WS_EX_RIGHT tarzı statik ya da düzenleme denetimleri kullanarak sırasıyla SS_RIGHT veya ES_RIGHT stilini kullanarak aynı etkiye sahiptir. Bu düğme denetimleri kullanarak BS_RIGHT ve BS_RIGHTBUTTON stilleri kullanarak aynı etkiye sahiptir.

lpClassName

Bir boş sonlandırılmış dize işaretçisi veya bir tamsayı atom. LpClassName atom ise, önceki çağrısıyla oluşturulan küresel bir atom olmalıdır GlobalAddAtom. Atom, 16 bitlik bir değer 0xC000, az lpClassNamealt sıra Word'de olmalıdır; yüksek sıralı sözcük sıfır olmalıdır.

LpClassName bir dize ise, pencere sınıfı adını belirtir. Sınıf adı RegisterClassEx işlevi veya önceden tanımlanmış denetim sınıfı adları herhangi bir kayıtlı herhangi bir ad olabilir.

lpWindowName

Pencere adı belirten bir boş sonlandırılmış dize işaretçisi.

Başlık çubuğu pencere stili belirtir, lpWindowName tarafından işaret belgili tanımlık pencere başlık başlık çubuğunda görüntülenir. Cw_usedefault düğmeler, onay kutuları ve statik denetimleri gibi denetimler oluşturmak için kullanırken denetim metnini belirtmek için lpWindowName kullanın.

dwStyle

Oluşturuluyor penceresindeki stilini belirtir. Bu parametreyi aşağıdaki pencere stilleri bir arada olabilir, ayrıca Denetim stilleri açıklamalar bölümünde belirtilen.

Stil	Anlamı
WS_BORDER	İnce çizgi kenarlığı olan bir pencere oluşturur.
WS_CAPTION	(ws_border stili içerir) başlık çubuğu olan bir pencere oluşturur.
WS_CHILD	Alt pencere oluşturur. Bu tarz ws_popup stille kullanılamaz.
WS_CHILDWINDOW	WS_CHILD stilini aynıdır.
WS_CLIPCHILDREN	Çizim üst pencere içinde oluştuğunda çocuk windows tarafından işgal alanı dışarıda bırakır. Bu tarz üst pencere oluşturulurken kullanılır.
WS_CLIPSIBLINGS	Küçük çocuk windows birbirlerine göre; başka bir deyişle, belirli alt pencere aldığında bir WM_PAINT mesaj, WS_CLIPSIBLINGS tarzı klipler tüm diğer çakışan alt pencereleri bölgenin güncelleştirilmesi için alt penceresinin dışına. WS_CLIPSIBLINGS belirtilen ve alt pencereleri üst üste, komşu alt pencere istemci alanı içinde çizmek için alt pencere, istemci alanı içindeki çizim yaparken, mümkündür.
WS_DISABLED	Başlangıçta devre dışı bırakılmış bir pencere oluşturur. Engelli bir pencere kullanıcıdan girdi alınamıyor.
WS_DLGFRAME	Genellikle iletişim kutularında kullanılan stilin bir kenarlığa sahip bir pencere oluşturur. Bu tarz bir pencere başlık çubuğu olamaz.
WS_GROUP	Bir denetim grubu ilk denetimi belirtir. Bu ilk ve sonra ws_group stili ile bir sonraki denetime kadar tanımlanmış tüm denetimi grup oluşur. Kullanıcı grubu başka bir grup hareket etmelerini sağlayacak şekilde her gruptaki ilk denetim genellikle ws_tabstop tarzı vardır. Kullanıcı daha sonra klavye odağını gruptaki bir denetimi grubunda sonraki denetime yön tuşlarını kullanarak değiştirebilirsiniz.
WS_HSCROLL	Bir yatay kaydırma çubuğu olan bir pencere oluşturur.
WS_ICONIC	Başlangıçta simge durumuna küçültülmüş pencere oluşturur. Aynı şekilde WS_MINIMIZE stili.
WS_MAXIMIZE	Başlangıçta ekranı kaplamış pencere oluşturur.
WS_MAXIMIZEBOX	Ekranı Kapla düğmesi olan bir pencere oluşturur. ws_ex_contexthelp tarzı ile birleştirilemez. ws_sysmenu stili de belirtilmelidir.
WS_MINIMIZE	Başlangıçta simge durumuna küçültülmüş pencere oluşturur. Aynı şekilde WS_ICONIC stili.
WS_MINIMIZEBOX	Simge durumuna Küçült düğmesini içeren bir pencere oluşturur. ws_ex_contexthelp tarzı ile birleştirilemez. ws_sysmenu stili de belirtilmelidir.
WS_OVERLAPPED	Çakışan bir pencere oluşturur. Çakışan bir pencere başlık çubuğu ve bir sınır vardır. Aynı şekilde WS_TILED stili.
WS_OVERLAPPEDWINDOW	Ws_overlapped, WS_CAPTION, ws_sysmenu WS_THICKFRAME, WS_MINIMIZEBOX ve WS_MAXIMIZEBOX stilleri ile örtüşen bir pencere oluşturur. Aynı şekilde WS_TILEDWINDOW stili.
WS_POPUP	Bir pop-up penceresi oluşturur. Bu stil WS_CHILD stille kullanılamaz.
WS_POPUPWINDOW	Açılır pencere, ws_border, ws_popup ve ws_sysmenu stilleriyle oluşturur. WS_CAPTION ve WS_POPUPWINDOW stilleri pencere menüsü görünür hale getirmek için birlikte olmalıdır.
WS_SIZEBOX	Boyutlandırma kenarlığa sahip bir pencere oluşturur. Aynı şekilde WS_THICKFRAME stili.
WS_SYSMENU	Başlık çubuğunu pencerenin menü içeren bir pencere oluşturur. WS_CAPTION stil de belirtilmelidir.
WS_TABSTOP	Kullanıcı SEKME tuşuna bastığında, klavye odağı alabilen bir denetimi belirtir. SEKME tuşuna basarak ws_tabstop stili ile bir sonraki denetime klavye odağını değiştirir.
WS_THICKFRAME	Boyutlandırma kenarlığa sahip bir pencere oluşturur. Aynı şekilde WS_SIZEBOX stili.
WS_TILED	Çakışan bir pencere oluşturur. Çakışan bir pencere başlık çubuğu ve bir sınır vardır. Aynı şekilde ws_overlapped stili.
WS_TILEDWINDOW	Ws_overlapped, WS_CAPTION, ws_sysmenu WS_THICKFRAME, WS_MINIMIZEBOX ve WS_MAXIMIZEBOX stilleri ile örtüşen bir pencere oluşturur. Aynı şekilde WS_OVERLAPPEDWINDOW stili.
WS_VISIBLE	Başlangıçta görünür pencere oluşturur.
WS_VSCROLL	Dikey bir kaydırma çubuğu olan bir pencere oluşturur.

x

Pencerenin başlangıçtaki yatay konumunu belirtir. Çakışan veya açılır pencere için ilk x-koordinatı Ekran koordinatlarındaki pencerenin sol üst köşesinin x parametresidir. Bir çocuk için x göreli olarak ana pencerenin istemci alanının sol üst köşesini pencerenin sol üst köşesindeki x-koordinatı penceredir.

X üste için ayarlanmışsa, sistem için pencerenin sol üst köşesindeki varsayılan konumunu belirler ve y parametresi yok sayar. Üste örtüşmüş windows için geçerlidir. için belirtilmişse pop-up veya alt penceresi, x ve y parametrelerinin sıfır olarak ayarlanır.

y

Pencerenin başlangıçtaki dikey konumunu belirtir. Çakışan veya açılır pencere için ilk y-koordinatı Ekran koordinatlarındaki pencerenin sol üst köşesinin y parametresidir. Bir çocuk için y ilk y-koordinatı ana pencerenin istemci alanının sol üst köşesine göredir alt penceresinin sol üst köşesindeki penceredir. Bir liste kutusu, y ise ilk y-koordinatı ana pencerenin istemci alanının sol üst köşesine göredir liste kutusunun istemci alanının sol üst köşesindeki.

WS_VISIBLE stil bit kümesi ile örtüşen bir pencere oluşturulur ve x parametresi için üste ayarlanır, sistem, y parametresi yoksayar.

nWidth

Cihaz birimleri penceresinin, genişliğini belirtir. Örtüşen pencereler için nWidth pencere ekran koordinatları ya da üste genişliktir. NWidth üste ise, sistem varsayılan genişlik ve Yükseklik için pencere seçer; Varsayılan genişliği ilk x-koordinatlarından ekranın sağ kenarına doğru uzanır; varsayılan yüksekliğini ilk y-koordinatı simge alanının üstüne uzanır. Üste örtüşmüş windows için geçerlidir. üste bir pop-up veya alt penceresi belirtilirse, nWidth ve nHeight parametresi sıfıra ayarlanır.

nHeight

Aygıt birimlerle penceresinin, yüksekliğini belirtir. Örtüşen pencereler için nHeight pencere Ekran koordinatlarındaki yüksekliktir. NWidth parametresi için üste ayarlanırsa, sistem, nHeight yoksayar.

hWndParent

Oluşturulan pencerenin üst veya sahibi pencereye kolu. Alt pencere ya da sahip olunan bir pencere oluşturmak için geçerli pencere işleyicisi sağlayın. Bu parametre için açılır pencereler isteğe bağlı.

Windows NT 5.0 ve sonraki sürümleri: İletinin yalnızca bir pencere oluşturmak için hwnd_message ya da varolan yalnızca ileti penceresini tanıtıcı tedarik.

hMENU'nun

Menüye işlemek veya pencere stili bağlı bir alt pencere tanımlayıcısını belirtir. İçin bir örtüşen veya açılır pencere, menü penceresi ile kullanılacak HMENU'nun tanımlar; sınıf menüsünde kullanılacak ise boş olabilir. Alt pencere için HMENU'nun alt-pencere tanıtıcısı, üst olaylar hakkında bilgilendirmek için bir iletişim kutusu denetimi tarafından kullanılan bir tamsayı değeri belirtir. Uygulama, alt-pencere tanıtıcısı belirler; Ana pencere ile alt pencereler için benzersiz olmalıdır.

hINSTANCE

Pencere ile ilişkili modülü örneğini ele.

lpParam

Pencereye createstruct yapısı iletilmek üzere bir değeri için bir işaretçi lParam parametresinde wm_create mesaj geçti. Birden çok belge arabirim (MDI) istemci penceresi oluşturmak için bir uygulama çağrıları Cw_usedefault , lpParam bir CLIENTCREATESTRUCT yapısına işaret gerekir.

Dönüş değerleri

İşlev başarılı olursa, iade yeni pencerenin tanıtıcı değerdir.

İşlev başarısız olursa, dönüş değeri null olur. Genişletilmiş hata bilgilerini için GetLastError.

Açıklamalar

CreateWindowEx işlevi, oluşturuluyor penceresindeki wm_nccreate, WM_NCCALCSIZE ve wm_create iletileri gönderir.

Görev çubuğunda bir düğme için oluşturulan pencerenin görüntülenip görüntülenmeyeceğini denetleme hakkında daha fazla bilgi için bkz: Görünürlük görev çubuğu düğmeleri.

Aşağıdaki önceden tanımlanmış denetim sınıfları lpClassName parametre belirtilebilir. Not ilgili denetimin, stilleri dwStyle parametre kullanabilirsiniz.

Windows 95: Sistem-ebilmek çekmek en çok 16,364 pencere kolları.

Windows ce: Windows ce bağımsız menü çubukları desteklemez. Bir alt pencere tanıtıcısı kullanılmadığı sürece HMENU'nun parametre null olmalıdır.

Windows ce 2.0 ve sonraki sürümleri aşağıdaki iki geniş pencere stil desteği:

WS_EX_NOACTIVATE

Bu stili ile oluşturulan üst düzey pencere etkinleştirilemiyor. Alt pencere bu tarzı varsa, bunu dokunarak etkinleştirilmesi üst düzey üst neden olmaz. Bu stilde pencere-ecek almak kalemi olaylar, ama ne o, ne de kendi alt pencereleri odağı alabilir.

WS_EX_NOANIMATION

Bu stili ile oluşturulan bir pencere animasyonlu patlayan ve dikdörtgenler imploding göstermez ve görev çubuğunda bir düğme yok.

Aşağıdaki dwExStyle bayrakları desteklenmez.

Windows ce 1.0 ws_ex_topmost stilini desteklemez. 2.0 Ve sonraki sürümlerde yapmak.

Aşağıdaki dwStyle bayrakları desteklenmez.

Tüm windows örtülü olarak WS_CLIPSIBLINGS ve WS_CLIPCHILDREN stiller var.

Windows ce 1.0 iletişim kutularını haricinde sahipli windows desteklemez. HwndParent parametresi null değilse, pencerenin WS_CHILD stilini örtülü olarak verilir.

QuickInfo

nbsp; Windows &NT: sürüm 3.1 veya üstü gerektirir.
Windows:Windows 95 veya sonraki sürümleri gerektirir.
Windows ce:Sürüm 1.0 veya daha ilerisini gerektirir.
Header:WINUSER.h ilan etti.
İçe Library:User32.lib kullanın.
Unicode:Unicode ve ANSI sürümleri Windows NT olarak uygulanır.

Ayrıca bkz:

Windows genel bakış, pencere işlevleri, CLIENTCREATESTRUCT, createstruct, Cw_usedefault, GlobalAddAtom, RegisterClassEx, SetWindowPos, wm_create, WM_NCCALCSIZE, wm_nccreate, WM_PAINT, WM_PARENTNOTIFY

Index