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) |