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)

另請參閱

繪製和繪圖函式

繪製和繪圖概觀