複製鏈接
請複製以下鏈接發送給好友

CreateWindow

鎖定
WindowsAPI函數, 在WinUser.h中根據是否已定義Unicode被分別定義為CreateWindowW和CreateWindowA,然後兩者又被分別定義為對CreateWindowExW和CreateWindowExA函數的調用。 [1] 
中文名
CreateWindow
外文名
CreateWindow
聲明位置
WinUser.h和Windows.h
操作系統版本
Windows 2000 專業版及更高版本
用    途
編程

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; [1] 

CreateWindow主要參數

CreateWindow詳情

lpClassName
指向一個空結束的字符串或整型數atom。如果該參數是一個整型量,它是由此前調用theGlobalAddAtom函數產生的全局量。這個小於0xC000的16位數必須是lpClassName參數字的低16位,該參數的高位必須是0。
如果lpClassName是一個字符串,它指定了窗口的類名。這個類名可以是任何用函數RegisterClass註冊的類名,或是任何預定義的控制類名。請看説明部分的列表。
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_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:創建一個有垂直滾動條的窗口。
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座標開始到屏幕的右邊界,缺省高度為從初始Y座標開始到目標區域的頂部。CW_USEDEFAULT只對層疊窗口有效;如果為彈出式窗口和子窗口設定CW_USEDEFAULT標誌則nWidth和nHeight被設為零。
nHeight
以設備單元指明窗口的高度。對於層疊窗口,nHeight是屏幕座標的窗口寬度。若nWidth被設為CW_USEDEFAULT,則系統忽略nHeight參數。
hWndParent
指向被創建窗口的父窗口或所有者窗口的句柄。若要創建一個子窗口或一個被屬窗口,需提供一個有效的窗口句柄。這個參數對彈出式窗口是可選的。Windows NT 5.0;創建一個消息窗口,可以提供HWND_MESSAGE或提供一個己存在的消息窗口的句柄。
hMenu
菜單句柄,或依據窗口風格指明一個子窗口標識。對於層疊或彈出式窗口,hMenu指定窗口使用的菜單:如果使用了菜單類,則hMenu可以為NULL。對於子窗口,hMenu指定了該子窗口標識(一個整型量),一個對話框使用這個整型值將事件通知父類。應用程序確定子窗口標識,這個值對於相同父窗口的所有子窗口必須是唯一的。
hlnstance
與窗口相關聯的模塊實例的句柄。
lpParam
指向一個值的指針,該值傳遞給窗口WM_CREATE消息。該值通過在IParam參數中的CREATESTRUCT結構傳遞。如果應用程序調用CreateWindow創建一個MDI客户窗口,則lpParam必須指向一個CLIENTCREATESTRUCT結構。
返回值:如果函數成功,返回值為新窗口的句柄:如果函數失敗,返回值為NULL。若想獲得更多錯誤信息,請調用GetLastError函數 [1] 

CreateWindow其他信息

在返回前,CreateWindow給窗口過程發送一個WM_CREATE消息。對於層疊,彈出式和子窗口,CreateWindow給窗口發送WM_CREATE,WM_GETMINMAXINFO和WM_NCCREATE消息。消息WM_CREATE的IParam參數包含一個指向CREATESTRUCT結構的指針。如果指定了WS_VISIBLE風格,CreateWindow向窗口發送所有需要激活和顯示窗口的消息。 [2] 

CreateWindow其它參數

獲取有關任務條是否為創建的窗口顯示一個按鈕的控制信息,參看Taskbar按鈕的Visbility。
以下預定義的控制類可以在lpClassName參數中指定。注意在dwStyle參數中可以使用的相應的控制風格。 [1] 

CreateWindowBUTTON按鈕

按鈕是一個小矩形子窗口,用户可以點擊來打開或關閉。按鈕控制可以單獨使用或包含在組中使用,可以為控制寫標籤或不寫標籤。當用户點擊按鈕控制時按鈕的外觀有明顯的改變。請參看Button。查看dwStyle參數中指定的按鈕風格表請參考Button Style。
COMBOBOX組合框由一個列表框和一個類似於編輯控制的選擇域組成。在使用這個風格控制時,應用程序或者使列表框一直顯示或者是作成一個下拉列表。如果列表框可見,則在編輯域中輸入字符將使列表框中與字符一致的第一個域高亮。反之,在列表框中選擇的項將顯示在編輯域中。請參看Combo Boxes。 [2] 

CreateWindowdwStyle參數

中指定的組合框風格表請參考Combo Boxes Style。
EDIT編輯框一個小的矩形子窗口用户可以使用鍵盤向其中輸入文本。用户可以通過點擊或按Tab鍵來選中編輯框控制並且使控制獲得焦點。當編輯框中顯示一個閃爍的插入記號時,用户可以輸入文本。使用鼠標移動光標,選擇被替換的字符或設置插入字符的位置或使用回退鍵刪除字符。請參看Edit。controls。
查看dwStyle參數中指定的編輯框風格的表格請參考Edit Control Style。
LISTBOX列表框字符串的列表。當應用程序必須顯示名稱的列表,例如文件名列表等,使用户可以從中選擇時就可指定列表框。用户可以通過單擊來選擇名稱。選擇時,被選擇名高亮,同時傳遞給父窗口一個通知消息。請參看LiSt Box Style。查看dwStyle參數中指定的列表風格表請參考List BOX Control Style。

CreateWindowMDI客户窗口

窗口接收控制MDI應用程序子窗口的消息。建議使用兩種控制風格位:WS_CLIPCHILDREN和WS_CHILD。指定了WS_HSCROLL和WS_VSCROLL風格的MDI客户窗口允許用户將MDI子窗口滑動進入視窗。請參看MDI。
RiChEdit設計一個Rich Editl.0版的控制,該控制使用户可以以字符和段落格式測覽和編輯文本;RICHEDIT CLASS設計一個Rich Edik2.0版的控制,該控制使用户可以以字符和段落格式測覽和編輯文本,兩者的共同點是都可以包含嵌入的COM對象。請參看Rich Edit Controls,查看dwStyle參數中指定的RichEdit風格表請參考LiSt Box Control Style和RichEditControIStyle。
SCROLLBAR 滾動條設計的一個包含着一個滾動盒和兩端有方向箭頭的矩形。只要用户點擊了控制,滾動條就給父窗口發送一個通知消息。如有必要,父窗口負責更新滾動條的位置。請參看ScrollBars。查看dwStyle參數中指定的滾動條風格表請參考Scroll Bars Style。 [3-4] 

CreateWindow靜態文本域

文本盒或矩形用於給控制加標籤,組合控制或將控制與其他控制分開。
靜態控制不提供輸入和也不提供輸出。請參看Static Control Styles。查看dwStyle參數中指定的靜態文本風格表請參考Scroll Bars Style。
Windows95:系統可以支持最大16,364個窗口句柄
備註:如果在鏈接應用程序時指明是Windows 4.x版本,除非應用程序的窗口有窗口某單,否則窗口控制沒有標題控制。對Windows3.x版本沒有這種要求。

CreateWindowWindows CE

CreateWindow是以“宏”方式完成的。它被定義為CreateWindowEX,並且dwExStyle參數被置為長整數0。不支持菜單條控制,除非被聲明為子窗口標誌否則hMenu參數必須為NULL。不支持MDICLIENT窗口類。dwStyle參數可以是對話框(Dialogue Box),窗口(Windows),控制(Controls)文件中的窗口風格和控制風格的組合。 [5] 

CreateWindow其他信息

下列dwStyle標誌在窗口中不支持
WS_CHILDWINDOW WS_ICONC;WS_MAXMIZE WS_MAXIMIZEBOX;WS_MINIMIZE WS_MINIMIZEBOX;
WS_OVERLAPPEDWINDOW WS_POPUPWINDOW;WS_SIZEBOXWS_THICKFRAME WS_TILED WS_TILEDWINDOW
下列dwStyle標誌在控制和對話框中不支持:
不支持的按鈕風格和靜態控制風格
BS_LEFTTEXT SS_BLACKFRAME;BS_MULTILINE SS_GRAYFRAME BS_TEXT SS_METAPICT;BS_USERBUTTON SS_SIMPLE
不支持組合框SS_WHITERECT風格。
CBS_OWNERDRAWFIXED SS_BLACKRECT;CBS_OWNWEDRAWVARIABLE SS_GRAYRECT; CBS_SIMPLE8R舊HTrIMAGE
不支持列表框控制SS_WHITEFRAME風格。
LBS_NODATA
不支持的對話框風格
LBS_OWNERDRAWFIXED DS_ABSALIGN; LBS_OWNERDRAWVARIABLE DS_CENTERMOUSE; LBS_STANDARD DS_CONTEXTHELP
不支持滾動條的 DS_FIXEDSYS風格
SBS_BOTTOMALIGN DS_NOFAILCREATE;SBS_RIGHTALIGN DS_NOIDLEMSG;
SBS_SlZEBOXBOTT0MRIHTALIGN DS_SYSMODAL;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兩種版本。 [2] 

CreateWindow示例

//Window.cpp:Defines the entry point for the application.

//

//#include "stdafx.h"

#include <windows.h>

LRESULT CALLBACK WndProc(HWND, UINT, WPARAM, LPARAM);

int APIENTRY WinMain(HINSTANCE hInstance,//應用程序的實例句柄,

HINSTANCE hPrevInstance,

LPSTR lpCmdLine,//命令行

int nCmdShow)//顯示方式

{

MSG msg;

HWND hWnd;

char szTitle[] = "系統信息";//The title bar text

char szWindowClass[] = "popMsg";//The title bar text

WNDCLASSEX wcex = {0};

wcex.cbSize = sizeof(WNDCLASSEX);//WNDCLASSEX結構體大小

wcex.style = CS_HREDRAW | CS_VREDRAW;//位置改變時重繪

wcex.lpfnWndProc = (WNDPROC)WndProc;//消息處理函數

wcex.hInstance = 0;//當前實例句柄

wcex.hbrBackground = (HBRUSH)COLOR_WINDOWFRAME;//背景色

wcex.lpszClassName = szWindowClass;//參窗口類名

wcex.hIcon = 0;//圖標

wcex.hCursor = LoadCursor(NULL, IDC_ARROW);//光標

wcex.lpszMenuName = 0;//菜單名稱

wcex.hIconSm = 0;//最小化圖標

RegisterClassEx(&wcex);//註冊窗口類

參考資料