getWindowRgn 函式 (winuser.h)
GetWindowRgn函式會取得視窗視窗區域的複本。 視窗的視窗區域是藉由呼叫 SetWindowRgn 函式來設定。 視窗區域會決定系統允許繪製之視窗內的區域。 系統不會顯示視窗區域外的任何視窗部分
語法
int GetWindowRgn(
[in] HWND hWnd,
[in] HRGN hRgn
);
參數
[in] hWnd
要取得其視窗區域的視窗控制碼。
[in] hRgn
將修改為代表視窗區域的區域控制碼。
傳回值
傳回值會指定函式取得的區欄位型別。 它可以是下列值之一。
傳回碼 | 描述 |
---|---|
|
區域是空的。 |
|
區域是單一矩形。 |
|
區域是一個以上的矩形。 |
|
指定的視窗沒有區域,或嘗試傳回區域時發生錯誤。 |
備註
視窗視窗區域的座標相對於視窗的左上角,而不是視窗的工作區。
若要設定視窗的視窗區域,請呼叫 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 版) |