-
CreateWindowEx
鎖定
CreateWindowEx是一個計算機函數，該函數用來創建一個具有擴展風格的層疊式窗口、彈出式窗口或子窗口，其他功能與CreateWindow函數相同。
- 中文名
- 創建窗口
- 外文名
- CreateWindowEx
- 聲明位置
- WinUser.h
- 釋 義
- 計算機函數
CreateWindowEx函數功能
該函數創建一個具有擴展風格的層疊式窗口、彈出式窗口或子窗口，其他與CreateWindow函數相同。關於創建窗口和其他參數的內容，請參看CreateWindow。
CreateWindowEx函數原型
CreateWindowEx函數創建一個層疊的，自動彈出的（pop－up）或是一個子窗口通過擴展格式。另外這個函數的作用與CreateWindow函數的作用相同。要獲得更多的關於創建窗口的信息和關於CreateWindowEx函數參數的詳細描述。參見CreateWindow
[1]
HWND CreateWindowEx( DWORD DdwExStyle, //窗口的擴展風格 LPCTSTR lpClassName, //指向註冊類名的指針 LPCTSTR lpWindowName, //指向窗口名稱的指針 DWORD dwStyle, //窗口風格 int x, //窗口的水平位置 int y, //窗口的垂直位置 int nWidth, //窗口的寬度 int nHeight, //窗口的高度 HWND hWndParent, //父窗口的句柄 HMENU hMenu, //菜單的句柄或是子窗口的標識符 HINSTANCE hInstance, //應用程序實例的句柄 LPVOID lpParam //指向窗口的創建數據 );
CreateWindowEx參數
dwExStyle
指定窗口的擴展風格。該參數可以是下列值：
WS_EX_NODRAG:防止窗口被移動
WS_EX_ACCEPTFILES：指定以該風格創建的窗口接受一個拖拽文件。
WS_EX_APPWINDOW：當窗口可見時，將一個頂層窗口放置到任務條上。
WS_EX_CLIENTEDGE：指定窗口有一個帶陰影的邊界。
WS_EX_CONTEXTHELP：在窗口的標題條包含一個問號標誌。當用户點擊了問號時，鼠標光標變為一個問號的指針、如果點擊了一個子窗口，則子窗口接收到WM_HELP消息。子窗口應該將這個消息傳遞給父窗口過程，父窗口再通過HELP_WM_HELP命令調用WinHelp函數。這個Help應用程序顯示一個包含子窗口幫助信息的彈出式窗口。 WS_EX_CONTEXTHELP不能與WS_MAXIMIZEBOX和WS_MINIMIZEBOX同時使用。
WS_EX_CONTROLPARENT：允許用户使用Tab鍵在窗口的子窗口間搜索。
WS_EX_DLGMODALFRAME：創建一個帶雙邊的窗口；該窗口可以在dwStyle中指定WS_CAPTION風格來創建一個標題欄。
WS_EX_LAYERED：創建一個分層窗口
WS_EX_LEFT：窗口具有左對齊屬性，這是缺省設置的。
WS_EX_LEFTSCROLLBAR：如果外殼語言是如Hebrew，Arabic，或其他支持reading order alignment的語言，則標題條（如果存在）則在客户區的左部分。若是其他語言，在該風格被忽略並且不作為錯誤處理。
WS_EX_LTRREADING：窗口文本以LEFT到RIGHT（自左向右）屬性的順序顯示。這是缺省設置的。
WS_EX_MDICHILD：創建一個MDI子窗口。
WS_EX_NOPATARENTNOTIFY：指明以這個風格創建的窗口在被創建和銷燬時不向父窗口發送WM_PARENTNOTIFY消息。
WS_EX_OVERLAPPEDWINDOW：WS_EX_CLIENTEDGE和WS_EX_WINDOWEDGE的組合。
WS_EX_PALETTEWINDOW：WS_EX_WINDOWEDGE, WS_EX_TOOLWINDOW和WS_WX_TOPMOST風格的組合WS_EX_RIGHT:窗口具有普通的右對齊屬性，這依賴於窗口類。只有在外殼語言是如Hebrew,Arabic或其他支持讀順序對齊（reading order alignment）的語言時該風格才有效，否則，忽略該標誌並且不作為錯誤處理。
WS_EX_RIGHTSCROLLBAR：垂直滾動條在窗口的右邊界。這是缺省設置的。
WS_EX_RTLREADING：如果外殼語言是如Hebrew，Arabic，或其他支持讀順序對齊（reading order alignment）的語言，則窗口文本是一自左向右RIGHT到LEFT順序的讀出順序。若是其他語言，在該風格被忽略並且不作為錯誤處理。
WS_EX_STATICEDGE：為不接受用户輸入的項創建一個3一維邊界風格
WS_EX_TOOLWINDOW：創建工具窗口，即窗口是一個遊動的工具條。工具窗口的標題條比一般窗口的標題條短，並且窗口標題以小字體顯示。工具窗口不在任務欄裏顯示，當用户按下alt+Tab鍵時工具窗口不在對話框裏顯示。如果工具窗口有一個系統菜單，它的圖標也不會顯示在標題欄裏，但是，可以通過點擊鼠標右鍵或Alt+Space來顯示菜單。
WS_EX_TOPMOST：指明以該風格創建的窗口應放置在所有非最高層窗口的上面並且停留在其L，即使窗口未被激活。使用函數SetWindowPos來設置和移去這個風格。
WS_EX_TRANSPARENT：指定以這個風格創建的窗口在窗口下的同屬窗口已重畫時，該窗口才可以重畫。
由於其下的同屬窗口已被重畫，該窗口是透明的。
IpClassName
指向一個空結束的字符串或整型數atom。如果該參數是一個整型量，它是由此前調用RegisterClass或RegisterClassEx函數返回的值。這個小於OxCOOO的16位數必須是IpClassName參數字的低16位，該參數的高位必須是O。
如果lpClassName是一個字符串，它指定了窗口的類名。這個類名可以是任何用函數RegisterClassEx註冊的類名，或是任何預定義的控制類名。請看説明部分的列表。
lpWindowName
指向一個指定窗口名的空結束的字符串指針。
如果窗口風格指定了標題條，由lpWindowName指向的窗口標題將顯示在標題條上。當使用CreateWindow
函數來創建控制例如按鈕，選擇框和靜態控制時，可使用lpWindowName來指定控制文本。
dwStyle
指定創建窗口的風格。該參數可以是下列窗口風格的組合再加上説明部分的控制風格。
x：指定窗口的初始水平位置。對一個層疊或彈出式窗口，X參數是屏幕座標系的窗口的左上角的初始X座標。對於子窗口，x是子窗口左上角相對父窗口客户區左上角的初始X座標。如果該參數被設為CW_USEDEFAULT則系統為窗口選擇缺省的左上角座標並忽略Y參數。CW_USEDEFAULT只對層疊窗口有效，如果為彈出式窗口或子窗口設定，則X和y參數被設為零。
y：指定窗口的初始垂直位置。對一個層疊或彈出式窗日，y參數是屏幕座標系的窗口的左上角的初始y座標。對於子窗口，y是子窗口左上角相對父窗口客户區左上角的初始y座標。對於列表框，y是列表框客户區左上角相對父窗口客户區左上角的初始y座標。如果層疊窗口是使用WS_VISIBLE風格位創建的並且X參數被設為CW_USEDEFAULT，則系統將忽略y參數。
風格意義:
WS_BORDER：創建一個帶邊框的窗口。
WS_CAPTION：創建一個有標題框的窗口（包括WS_BODER風格）。
WS_CHILD：創建一個子窗口。這個風格不能與WS_POPUP風格合用。
WS_CHILDWINDOW：與WS_CHILD相同。
WS_CLIPCHILDREN：當在父窗口內繪圖時，排除子窗口區域。在創建父窗口時使用這個風格。
WS_CLIPSIBLINGS：排除子窗口之間的相對區域，也就是，當一個特定的窗口接收到WM_PAINT消息時，WS_CLIPSIBLINGS 風格將所有層疊窗口排除在繪圖之外，只重繪指定的子窗口。如果未指定WS_CLIPSIBLINGS風格，並且子窗口是層疊的，則在重繪子窗口的客户區時，就會重繪鄰近的子窗口。
WS_DISABLED：創建一個初始狀態為禁止的子窗口。一個禁止狀態的窗口不能接受來自用户的輸入信息。
WS_DLGFRAME：創建一個帶對話框邊框風格的窗口。這種風格的窗口不能帶標題條。
WS_GROUP：指定一組控制的第一個控制。這個控制組由第一個控制和隨後定義的控制組成，自第二個控制開始每個控制，具有WS_GROUP風格，每個組的第一個控制帶有WS_TABSTOP風格，從而使用户可以在組間移動。用户隨後可以使用光標在組內的控制間改變鍵盤焦點。
WS_HSCROLL：創建一個有水平滾動條的窗口。
WS_ICONIC：創建一個初始狀態為最小化狀態的窗口。與WS_MINIMIZE風格相同。
WS_MAXIMIZE：創建一個初始狀態為最大化狀態的窗口。
WS_MAXIMIZEBOX：創建一個具有最大化按鈕的窗口。該風格不能與WS_EX_CONTEXTHELP風格同時出現，同時必須指定WS_SYSMENU風格。
WS_OVERLAPPED：產生一個層疊的窗口。一個層疊的窗口有一個標題條和一個邊框。與WS_TILED風格相同。
WS_OVERLAPPEDWINDOW：創建一個具有WS_OVERLAPPED，WS_CAPTION，WS_SYSMENU WS_THICKFRAME，WS_MINIMIZEBOX，WS_MAXIMIZEBOX風格的層疊窗口，與WS_TILEDWINDOW風格相同。
WS_POPUP：創建一個彈出式窗口。該風格不能與WS_CHILD風格同時使用。
WS_POPUPWINDOW：創建一個具有WS_BORDER，WS_POPUP,WS_SYSMENU風格的窗口，WS_CAPTION和WS_POPUPWINDOW必須同時設定才能使窗口某單可見。
WS_SIZEBOX：創建一個可調邊框的窗口，與WS_THICKFRAME風格相同。
WS_SYSMENU：創建一個在標題條上帶有窗口菜單的窗口，必須同時設定WS_CAPTION風格。
WS_TABSTOP：創建一個控制，這個控制在用户按下Tab鍵時可以獲得鍵盤焦點。按下Tab鍵後使鍵盤焦點轉移到下一具有WS_TABSTOP風格的控制。
WS_THICKFRAME：創建一個具有可調邊框的窗口，與WS_SIZEBOX風格相同。
WS_TILED：產生一個層疊的窗口。一個層疊的窗口有一個標題和一個邊框。與WS_OVERLAPPED風格相同。
WS_TILEDWINDOW:創建一個具有WS_OVERLAPPED，WS_CAPTION，WS_SYSMENU， WS_THICKFRAME，WS_MINIMIZEBOX，WS_MAXIMIZEBOX風格的層疊窗口。與WS_OVERLAPPEDWINDOW風格相同。
WS_VISIBLE：創建一個初始狀態為可見的窗口。
WS_VSCROLL：創建一個有垂直滾動條的窗口。
nWidth
以設備單元指明窗口的寬度。對於層疊窗口，nWidth或是屏幕座標的窗口寬度或是CW_USEDEFAULT。若nWidth是CW_USEDEFAULT，則系統為窗口選擇一個缺省的高度和寬度：缺省寬度為從初始X座標開始到屏幕的右邊界，缺省高度為從初始X座標開始到目標區域的頂部。CW_USEDEFAULT只對層疊窗口有效；如果為彈出式窗口和子窗口設定CW_USEDEFAULT標誌則nWidth和nHeight被設為零。
nHeigth
以設備單元指明窗口的高度。對於層疊窗口，nHeight是屏幕座標的窗口寬度。若nWidth被設為CW_USEDEFAULT，則系統忽略nHeight參數。
hWndParent
指向被創建窗口的父窗口或所有者窗口的句柄。若要創建一個子窗口或一個被屬窗口，需提供一個有效的窗口句柄。這個參數對彈出式窗口是可選的。Windows NT 5.0；創建一個消息窗口，可以提供HWND_MESSAGE或提供一個己存在的消息窗口的句柄。
hMenu
菜單句柄，或依據窗口風格指明一個子窗口標識。對於層疊或彈出式窗口，hMenu指定窗口使用的菜單：如果使用了菜單類，則hMenu可以為NULL。對於子窗口，hMenu指定了該子窗口標識（一個整型量），一個對話框使用這個整型值將事件通知父類。應用程序確定子窗口標識，這個值對於相同父窗口的所有子窗口必須是唯一的。
hlnstance
與窗口相關聯的模塊實例的句柄。
lpParam
指向一個值的指針，該值傳遞給窗口WM_CREATE消息。該值通過在lParam參數中的CREATESTRUCT結構傳遞。如果應用程序調用CreateWindow創建一個MDI客户窗口，則lpParam必須指向一個CLIENTCREATESTRUCT結構。
返回值
如果函數成功，返回值為新窗口的句柄：如果函數失敗，返回值為NULL。若想獲得更多錯誤信息，請調用GetLastError函數。
備註
參見CreateWindow。
速查：Windows NT：3.1以上版本；Windows：95以上版本；Windows CE：1.0以上版本；頭文件：winuser.h；庫文件：USer32.lib;Unicode：在Windows NT上實現為Unicode和ANSI兩種版本。
CreateWindowEx實例
hWnd=CreateWindowEx(NULL,"MyClass","Title", WS_OVERLAPPEDWINDOW|WS_VISIBLE,500,500, 500,500,NULL,NULL,hinstance,NULL);
CreateWindowEx易語言
.版本 2
.DLL命令 CreateWindowEx, 整數型, "user32", "CreateWindowExA", , 創建窗口
.參數 dwExStyle, 整數型, , 窗口的擴展風格
.參數 lpClassName, 文本型, , 註冊類名
.參數 lpWindowName, 文本型, , 窗口名稱
.參數 dwStyle, 整數型, , 窗口風格
.參數 x, 整數型, , 窗口的水平位置
.參數 y, 整數型, , 窗口的垂直位置
.參數 nWidth, 整數型, , 窗口的寬度
.參數 nHeight, 整數型, , 窗口的高度
.參數 hWndParent, 整數型, , 父窗口的句柄
.參數 hMenu, 整數型, , 菜單的句柄或是子窗口的標識符
.參數 hInstance, 整數型, , 應用程序實例的句柄
.參數 lpParam, 整數型, , 指向窗口的創建數據
- 參考資料
-
- 1. CreateWindowEx ．微軟．2010-4-8[引用日期2018-08-05]
