GetClientRect

該函式獲取視窗客戶區的大小。注意一下：視窗的客戶區為視窗中除標題欄、選單欄之外的地方。

基本介紹

• 中文名：該函式獲取視窗客戶區的坐標。
• 外文名：GetClientRect
• 左上角坐標：（0，0）
• 視窗的客戶區：視窗中除標題欄、選單欄之外地方

函式功能

該函式獲取視窗客戶區的坐標。客戶區坐標指定客戶區的左上角和右下角。由於客戶區坐標是相對視窗客戶區的左上角而言的，因此左上角坐標為（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.