函式功能
該函式創建一個具有擴展風格的層疊式視窗、彈出式視窗或子視窗,其他與CreateWindow函式相同。關於創建視窗和其他參數的內容,請參看CreateWindow。
函式原型
CreateWindowEx函式創建一個層疊的,自動彈出的(pop-up)或是一個子視窗通過擴展格式。另外這個函式的作用與CreateWindow函式的作用相同。要獲得更多的關於創建視窗的信息和關於CreateWindowEx函式參數的詳細描述。參見CreateWindow
參數
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_PARENTNOTFY訊息。
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兩種版本。
實例
易語言
.版本 2
.DLL命令 CreateWindowEx, 整數型, "user32", "CreateWindowExA", , 創建視窗
.參數 dwExStyle, 整數型, , 視窗的擴展風格
.參數 lpClassName, 文本型, , 註冊類名
.參數 lpWindowName, 文本型, , 視窗名稱
.參數 dwStyle, 整數型, , 視窗風格
.參數 x, 整數型, , 視窗的水平位置
.參數 y, 整數型, , 視窗的垂直位置
.參數 nWidth, 整數型, , 視窗的寬度
.參數 nHeight, 整數型, , 視窗的高度
.參數 hWndParent, 整數型, , 父視窗的句柄
.參數 hMenu, 整數型, , 選單的句柄或是子視窗的標識符
.參數 hInstance, 整數型, , 應用程式實例的句柄
.參數 lpParam, 整數型, , 指向視窗的創建數據