GetUpdateRect 函式 (winuser.h)

GetUpdateRect函式會擷取最小矩形的座標，以完全括住指定視窗的更新區域。 GetUpdateRect 會擷取邏輯座標中的矩形。如果沒有更新區域， GetUpdateRect 會擷取空矩形， (將所有座標設定為零) 。

語法

BOOL GetUpdateRect(
  [in]  HWND   hWnd,
  [out] LPRECT lpRect,
  [in]  BOOL   bErase
);

[in] hWnd

要擷取其更新區域的視窗控制碼。

[out] lpRect

RECT結構的指標，該結構會以裝置單位為單位接收括住矩形的座標。

應用程式可以將此參數設定為 Null ，以判斷視窗是否有更新區域。如果此參數為 Null，如果更新區域存在， GetUpdateRect 會傳回非零，如果更新區域不存在，則傳回零。這提供簡單且有效率的方式，可判斷 WM_PAINT 訊息是否由不正確區域所產生。

[in] bErase

指定更新區域中的背景是否要清除。如果此參數為 TRUE ，且更新區域不是空的， GetUpdateRect 會將 WM_ERASEBKGND 訊息傳送至指定的視窗，以清除背景。

如果更新區域不是空的，則傳回值為非零。

如果沒有更新區域，則傳回值為零。

BeginPaint函式所擷取的更新矩形與GetUpdateRect所擷取的更新矩形相同。

BeginPaint會自動驗證更新區域，因此在呼叫BeginPaint之後立即對GetUpdateRect進行的任何呼叫都會擷取空的更新區域。


最低支援的用戶端	Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
目標平台	Windows
標頭	winuser.h (包括 Windows.h)
程式庫	User32.lib
Dll	User32.dll
API 集合	ext-ms-win-ntuser-draw-l1-1-0 (在 Windows 8)