GetClientRect

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.