GetClientRect函数 GetWindow函数

GetClientRect

目录

函数功能

函数原型

参数

返回值

要求

编辑本段函数功能

该函数获取窗口客户区的坐标。客户区坐标指定客户区的左上角和右下角。由于客户区坐标是相对窗口客户区的左上角而言的，因此左上角坐标为（0，0）

编辑本段函数原型

在Win32 SDK, 该API函数原型为

BOOL GetClientRect(

HWND hWnd, // 窗口句柄

LPRECT lpRect // 客户区坐标

);

在MFC中，该函数的原型为void GetClientRect(LPRECT lpRect) const;

编辑本段参数

hWnd:是程序窗口的句柄。

lpRect:是一个 指针，指向一个RECT类型的rectangle结构。该结构有四个LONG字段,分别为left、top、right和bottom。GetClientRect将这四个字段设定为窗口显示区域的尺寸。left和top字段通常设定为0。right和bottom字段设定为显示区域的宽度和高度（像素点数）。 也可以是一个CRect对象指针。CRect对象有多个参数，与RECT用法相同。

函数的作用总的来说就是把客户区的大小写进第二个参数所指的Rect结构当中。

编辑本段返回值

如果函数成功，返回一个非零值。

如果函数失败，返回零。要得到更多的 错误信息，请使用 GetLastError函数。

————————————————————————————————————————————————

GetWindow

目录

函数功能

参数

编辑本段函数功能

该函数返回与指定窗口有特定关系（如Z序或所有者）的 窗口句柄。

函数原型：HWND GetWindow（HWND hWnd，UNIT nCmd）；

编辑本段参数

hWnd：窗口句柄。要获得的窗口句柄是依据nCmd参数值相对于这个窗口的句柄。

nCmd：说明指定窗口与要获得句柄的窗口之间的关系。该参数值可以是下列之一：

GW_CHILD(&H5)：如果指定窗口是父窗口，则获得的是在Z序顶端的子窗口的句柄，否则为NULL。函数仅检查指定父窗口的子窗口，不检查继承窗口。

GW_ENABLEDPOPUP(&H6)：（WindowsNT 5.0）返回的句柄标识了属于指定窗口的处于使能状态弹出式窗口（检索使用第一个由GW_HWNDNEXT 查找到的满足前述条件的窗口）；如果无使能窗口，则获得的句柄与指定窗口相同。

GW_HWNDFIRST(&H0)：返回的句柄标识了在Z序最高端的相同类型的窗口。如果指定窗口是最高端窗口，则该句柄标识了在Z序最高端的最高端窗口；如果指定窗口是顶层窗口，则该句柄标识了在z序最高端的顶层窗口：如果指定窗口是子窗口，则句柄标识了在Z序最高端的同属窗口。

GW_HWNDLAST(&H1)：返回的句柄标识了在z序最低端的相同类型的窗口。如果指定窗口是最高端窗口，则该柄标识了在z序最低端的最高端窗口：如果指定窗口是顶层窗口，则该句柄标识了在z序最低端的顶层窗口；如果指定窗口是子窗口，则句柄标识了在Z序最低端的同属窗口。

GW_HWNDNEXT(&H2)：返回的句柄标识了在Z序中指定窗口下的相同类型的窗口。如果指定窗口是最高端窗口，则该句柄标识了在指定窗口下的最高端窗口：如果指定窗口是顶层窗口，则该句柄标识了在指定窗口下的顶层窗口；如果指定窗口是子窗口，则句柄标识了在指定窗口下的同属窗口。

GW HWNDPREV(&H3)：返回的句柄标识了在Z序中指定窗口上的相同类型的窗口。如果指定窗口是最高端窗口，则该句柄标识了在指定窗口上的最高端窗口；如果指定窗口是顶层窗口，则该句柄标识了在指定窗口上的顶层窗口；如果指定窗口是子窗口，则句柄标识了在指定窗口上的同属窗口。

GW_OWNER(&H4)：返回的句柄标识了指定窗口的所有者窗口（如果存在）。GW_OWNER与GW_CHILD不是相对的参数，没有父窗口的含义，如果想得到父窗口请使用GetParent()。例如：例如有时对话框的控件的GW_OWNER，是不存在的。

返回值：如果函数成功，返回值为 窗口句柄；如果与指定窗口有特定关系的窗口不存在，则返回值为NULL。

若想获得更多 错误信息，请调用GetLastError函数。

备注：在循环体中调用函数EnumChildWindow比调用GetWindow函数可靠。调用GetWindow函数实现该任务的 应用程序可能会陷入死循环或退回一个已被销毁的 窗口句柄。

速查：Windows NT：3.1以上版本；Windows：95以上版本；Windows CE：1.0以上版本；头文件：winuser.h；库文件：user32.lib。