CreateWindow
函數功能:該函數創建一個重疊式窗口、彈出式窗口或子窗口。它指定窗口類,窗口標題,窗口
風格,以及窗口的初始位置及大小(可選的)。該函數也指定該窗口的父窗口或所屬窗口(如果存在
的話),及窗口的菜單。若要使用除CreateWindow函數支持的風格外的擴展風格,則使用
CreateWindowEx函數代替CreateWindow函數。
函數原型:HWND CreateWindow(LPCTSTR lpClassName,LPCTSTR lpWindowName,DWORD
dwStyle,int x,int y,int nWidth,int nHeight,HWND hWndParent,HMENU hMenu,HANDLE
hlnstance,LPVOID lpParam);
參數:
lpClassName:指向一個空結束的字符串或整型數atom。如果該參數是一個整型量,它是由此前調
用theGlobalAddAtom函數產生的全局量。這個小於0xC000的16位數必須是lpClassName參數字的低16位
,該參數的高位必須是0。如果lpClassName是一個字符串,它指定了窗口的類名。這個類名可以是任
何用函數RegisterClassEx注冊的類名,或是任何預定義的控制類名。請看說明部分的列表。
lpWindowName:指向一個指定窗口名的空結束的字符串指針。
如果窗口風格指定了標題條,由lpWindowName指向的窗口標題將顯示在標題條上。當使用
Createwindow函數來創建控制例如按鈕,選擇框和靜態控制時,可使用lpWindowName來指定控制文本
。
dwStyle:指定創建窗口的風格。該參數可以是下列窗口風格的組合再加上說明部分的控制風格。
風格意義:
WS_BORDER:創建一個單邊框的窗口。
WS_CAPTION:創建一個有標題框的窗口(包括WS_BORDER風格)。
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_MINIMIZE:創建一個初始狀態為最小化狀態的窗口。與WS_ICONIC風格相同。
WS_MINIMIZEBOX:創建一個具有最小化按鈕的窗口。該風格不能與WS_EX_CONTEXTHELP風格同時出
現,同時必須指定WS_SYSMENU風格。
WS_OVERLAPPED:產生一個層疊的窗口。一個層疊的窗口有一個標題條和一個邊框。與WS_TILED風
格相同。
WS_OVERLAPPEDWINDOW:創建一個具有WS_OVERLAPPED,WS_CAPTION,WS_SYSMENU,WS_THICKFRAME
,WS_MINIMIZEBOX,WS_MAXMIZEBOX風格的層疊窗口,與WS_TILEDWINDOW風格相同。
WS_POPUP:創建一個彈出式窗口。該風格不能與WS_CHLD風格同時使用。
WS_POPUWINDOW:創建一個具有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 MS_THICKFRAME.
WS_MINIMIZEBOX,WS_MAXMIZEBOX風格的層疊窗口。與WS_OVERLAPPEDWINDOW風格相同。
WS_VISIBLE:創建一個初始狀態為可見的窗口。
WS_VSCROLL:創建一個有垂直滾動條的窗口。
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參數。
nWidth:以設備單元指明窗口的寬度。對於層疊窗口,nWidth或是屏幕坐標的窗口寬度或是
CW_USEDEFAULT。若nWidth是CW_USEDEFAULT,則系統為窗口選擇一個缺省的高度和寬度:缺省寬度為
從初始X坐標開始到屏幕的右邊界,缺省高度為從初始X坐標開始到目標區域的頂部。CW_USEDEFAULT只
參層疊窗口有效;如果為彈出式窗口和子窗口設定CW_USEDEFAULT標志則nWidth和nHeight被設為零。
nHeight:以設備單元指明窗口的高度。對於層疊窗口,nHeight是屏幕坐標的窗口寬度。若
nWidth被設為CW_USEDEFAULT,則系統忽略nHeight參數。
hWndParent:指向被創建窗口的父窗口或所有者窗口的旬柄。若要創建一個子窗口或一個被屬窗
口,需提供一個有效的窗口句柄。這個參數對彈出式窗日是可選的。Windows NT 5.0;創建一個消息
窗口,可以提供HWND_MESSAGE或提供一個己存在的消息窗口的句柄。
hMenu:菜單句柄,或依據窗口風格指明一個子窗口標識。對於層疊或彈出式窗口,hMenu指定窗
口使用的菜單:如果使用了菜單類,則hMenu可以為NULL。對於子窗口,hMenu指定了該子窗口標識(
一個整型量),一個對話框使用這個整型值將事件通知父類。應用程序確定子窗口標識,這個值對於
相同父窗口的所有子窗口必須是唯一的。
hInstance:與窗口相關聯的模塊事例的句柄。
lpParam:指向一個值的指針,該值傳遞給窗口 WM_CREATE消息。該值通過在lParam參數中的
CREATESTRUCT結構傳遞。如果應用程序調用CreateWindow創建一個MDI客戶窗口,則lpParam必須指向
一個CLIENTCREATESTRUCT結構。
返回值:如果函數成功,返回值為新窗口的句柄:如果函數失敗,返回值為NULL。若想獲得更多
錯誤信息,請調用GetLastError函數。
備注:在返回前,CreateWindow給窗口過程發送一個WM_CREATE消息。對於層疊,彈出式和子窗口
,CreateWindow給窗口發送WM_CREATE,WM_GETMINMAXINFO和WM_NCCREATE消息。消息WM_CREATE的
lParam參數包含一個指向CREATESTRUCT結構的指針。如果指定了WS_VISIBLE風格,CreateWindow向窗
口發送所有需要激活和顯示窗口的消息。
獲取有關任務條是否為創建的窗口顯示一個按鈕的控制信息,參看Taskbar按鈕的Visbility。
以下預定義的控制類可以在lpClassName參數中指定。注意在dwStyle參數中可以使用的相應的控制風
格。
BUTTON:按鈕,是一個小矩形子窗口,用戶可以點擊來打開或關閉。按鈕控制可以單獨使用或包
含在組中使用,可以為控制寫標簽或不寫標簽。當用戶點擊按鈕控制時按鈕的外觀有明顯的改變。請
參看Button。查看dwStyle參數中指定的按鈕風格表請參考Button Style。
COMBOBOX:組合框,由一個列表框和一個類似於編輯控制的選擇域組成。在使用這個風格控制時
,應用程序或者使列表框一直顯示或者是作成一個下拉列表。如果列表框可見,則在編輯域中輸入字
符將使列表框中與字符一致的第一個域高亮。反之,在列表框中選擇的項將顯示在編輯域中。請參看
Combo Boxes。
查看dwStyle參數中指定的組合框風格表請參考Combo Boxes Style。
EDIT:編輯框,一個小的矩形子窗口,用戶可以使用鍵盤向其中輸入文本。用戶可以通過點擊或
按Tab鍵來選中編輯框控制並且使控制獲得焦點。當編輯框中顯示一個閃爍的插入記號時,用戶可以輸
入文本。使用鼠標移動光標,選擇被替換的字符或設置插入字符的位置或使用回退鍵刪除字符。請參
看Edit controls。
查看dwStyle參數中指定的編輯框風格的表格請參考Edit Control Style。
LISTBOX:列表框,字符串的列表。當應用程序必須顯示名稱的列表,例如文件名列表等,使用戶
可以從中選擇時就可指定列表框。用戶可以通過單擊來選擇名稱。選擇時,被選擇名高亮,同時傳遞
給父窗口一個通知消息。請參看LiSt Box Style。查看dwStyle參數中指定的列表風格表請參考List
BOX Control Style。
MDICLIENT:客戶設計出MDI客戶窗口。窗口接收控制MDI應用程序子窗口的消息。建議使用兩種控
制風格位:WS_CLIPCHILDREN和WS_CHILD。指定了WS_HSCROLL和WS_VSCROLL風格的MDI客戶窗口允許用
戶將MDI子窗口滑動進入視窗。請參看MDI。
RichEdit:設計一個Rich Editl.0版的控制。該控制使用戶可以以字符和段落格式測覽和編輯文
本,並且可以包含嵌入的COM對象。請參看Rich Edit Controls。查看dwStyle參數中指定的RichEdit
風格表請參考List Box Control Style。
RICHEDIT_CLASS:設計一個Rich Edik2.0版的控制。該控制使用戶可以以字符和段落格式測覽和
編輯文本,並且可以包含嵌入的COM對象。請參看RichEditControls。查看dwStyle參數中指定的
RichEdit風格表請參考RichEditControIStyle。
SCROLLBAR: 滾動條,設計的一個包含着一個滾動盒和兩端有方向箭頭的矩形。只要用戶點擊了
控制,滾動條就給父窗口發送一個通知消息。如有必要,父窗口負責更新滾動條的位置。請參看
ScrollBars。查看dwStyle參數中指定的滾動條風格表請參考Scroll Bars Style。
STATIC:一個簡單的靜態文本域,文本盒或矩形用於給控制加標簽,組合控制或將控制與其他控
制分開。
靜態控制不提供輸入和也不提供輸出。請參看Static Control Styles。查看dwStyle參數中指定
的靜態文本風格表請參考Scroll Bars Style。
Windows95:系統可以支持最大16,364個窗口句柄。
備注:如果在鏈接應用程序時指明是Windows 4.x版本,除非應用程序的窗口有窗口某單,否則窗
口控制沒有標題控制。對Windows3.x版本沒有這種要求。
Windows CE:CreateWindow是以“宏”方式完成的。它被定義為CreateWindowEX,並且dwExStyle
參數被置為長整數0。不支持菜單條控制,除非被聲明為子窗口標志否則hMenu參數必須為NULL。不支
持MDICLIENT窗口類。dwStyle參數可以是對話框(Dialogue Box),窗口(Windows),控制
(Controls)文件中的窗口風格和控制風格的組合。
下列dwStyle標志在窗口中不支持:
WS_CHILDWINDOW;WS_ICONIC;WS_MAXIMIZE;WS_MAXIMIZEBOX;WS_MINIMIZE;WS_MINIMIZEBOX;
WS_OVERLAPPEDWINDOW;WS_POPUPWINDOW;WS_SIZEBOX;WS_THICKFRAME;WS_TILED;
WS_TILEDWINDOW
下列dwStyle標志在控制和對話框中不支持:
不支持的按鈕風格和靜態控制風格:
BS_LEFTTEXT;BS_MULTILINE;BS_TEXT;BS_USERBUTTON;
不支持的靜態控制風格:SS_BLACKFRAME;SS_GRAYFRAME;SS_METAPICT; SS_SIMPLE;
SS_WHITERECT;SS_BLACKRECT;SS_GRAYRECT;SS_RIGHTIMAGE;SS_WHITEFRAME
不支持組合框風格。
CBS_OWNERDRAWFIXED;CBS_OWNWEDRAWVARIABLE;CBS_SIMPLE
不支持列表框控制風格。
LBS_NODATA;LBS_OWNERDRAWFIXED;LBS_OWNERDRAWVARIABLE;LBS_STANDARD
不支持的對話框風格:
DS_ABSALIGN;DS_CENTERMOUSE;DS_CONTEXTHELP;DS_FIXEDSYS;DS_NOFAILCREATE;
DS_NOIDLEMSG;DS_SYSMODAL;
不支持滾動條的風格
SBS_BOTTOMALIGN SBS_RIGHTALIGN;SBS_SlZEBOXBOTT0MRIHTALIGN;SBS_SIZEGRIP
可使用BS_OWNERDRAW風格來代替BS_USERBUTTON風格。
可使用SS_LEFT或SS_LEFTNOWORDWRAP風格來代替靜態控制的SS_SIMPLE風格。
不支持MDICLIENT窗口類。
所有窗口都隱含WS_CLIPSIBLINGS和 WS_CLIPCHILDREN風格。
Windows CE1.0版除對話框外不支持被屬窗口。如果hwndParent參數不為NULL,則窗口隱含給出
WS_CHILD風格。Windows CE1.0不支持菜單條。
速查: Windows NT:3.1以上版本;Windows:95以上版本;Windows CE:1.0以上版本;頭文件
:winuser.h;庫文件:user32.lib; Unicode:在Windows NT上實現為Unicode和ANSI兩種版本。
