win32窗口机制之CreateWindow

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两种版本。