getWindowRgn 函式 (winuser.h)

GetWindowRgn函式會取得視窗視窗區域的複本。 視窗的視窗區域是藉由呼叫 SetWindowRgn 函式來設定。 視窗區域會決定系統允許繪製之視窗內的區域。 系統不會顯示視窗區域外的任何視窗部分

語法

int GetWindowRgn(
  [in] HWND hWnd,
  [in] HRGN hRgn
);

參數

[in] hWnd

要取得其視窗區域的視窗控制碼。

[in] hRgn

將修改為代表視窗區域的區域控制碼。

傳回值

傳回值會指定函式取得的區欄位型別。 它可以是下列值之一。

傳回碼 描述
NullREGION
區域是空的。
SIMPLEREGION
區域是單一矩形。
COMPLEXREGION
區域是一個以上的矩形。
ERROR
指定的視窗沒有區域,或嘗試傳回區域時發生錯誤。

備註

視窗視窗區域的座標相對於視窗的左上角,而不是視窗的工作區。

若要設定視窗的視窗區域,請呼叫 SetWindowRgn 函式

範例

下列程式碼示範如何傳入現有區域的控制碼。


HRGN hrgn = CreateRectRgn(0,0,0,0);
int regionType = GetWindowRgn(hwnd, hrgn);
if (regionType != ERROR) 
{ 
/* hrgn contains window region */ 
}
DeleteObject(hrgn); /* finished with region */

規格需求

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

另請參閱

繪製和繪圖函式

繪製和繪圖概觀

SetWindowRgn