共用方式為


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)

另請參閱

BeginPaint

GetUpdateRgn

InvalidateRect

繪製和繪製函式

繪製和繪圖概觀

矩形

UpdateWindow

ValidateRect