GetClientRect
计算机科学领域术语
该函数获取窗口客户区的大小。注意一下:窗口的客户区为窗口中除标题栏、菜单栏之外的地方。
函数功能
该函数获取窗口客户区的坐标。客户区坐标指定客户区的左上角和右下角。由于客户区坐标是相对窗口客户区的左上角而言的,因此左上角坐标为(0,0)。这里应该注意一下:坐标包含两种:屏幕坐标与客户区坐标。严格区分这两种坐标对于理解Windows编程是很重要的。
函数原型
在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函数。
要求
Windows NT/2000: Windows NT 3.1 或更高的版本.
Windows 95/98: Windows 95 或更高的版本.
Header: Declared in Winuser.h; include Windows.h.
Library: Use User32.lib.
参考资料
最新修订时间:2023-10-17 19:46
目录
概述
函数功能
函数原型
参数
参考资料