getUpdateRgn 函式 (winuser.h)
GetUpdateRgn函式會將視窗的更新區域複製到指定的區域,以擷取視窗的更新區域。 更新區域的座標是相對於視窗左上角 (,也就是用戶端座標) 。
語法
int GetUpdateRgn(
[in] HWND hWnd,
[in] HRGN hRgn,
[in] BOOL bErase
);
參數
[in] hWnd
使用要擷取之更新區域的視窗控制碼。
[in] hRgn
要接收更新區域的控制碼。
[in] bErase
指定是否應該清除視窗背景,以及是否應該繪製子視窗的非工作區。 如果此參數為 FALSE,則不會完成繪圖。
傳回值
傳回值表示所產生區域的複雜度;它可以是下列其中一個值。
值 | 意義 |
---|---|
COMPLEXREGION | 區域包含一個以上的矩形。 |
ERROR | 發生錯誤。 |
NullREGION | 區域是空的。 |
SIMPLEREGION | 區域是單一矩形。 |
備註
BeginPaint函式會自動驗證更新區域,因此在呼叫 BeginPaint之後立即對GetUpdateRgn所做的任何呼叫都會擷取空的更新區域。
規格需求
最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | winuser.h (包含 Windows.h) |
程式庫 | User32.lib |
Dll | User32.dll |
API 集合 | ext-ms-win-ntuser-draw-l1-1-0 (在 Windows 8) |