SetWindowRgn

region when region

SetWindowRgn 函式
The SetWindowRgn function sets the window region of a window. The window region determines the area within the window where the system permits drawing. The system does not display any portion of a window that lies outside of the window region
定義
int SetWindowRgn(HWND hWnd, HRGN hRgn, BOOL bRedraw);
int SetWindowRgn(HRGN hRgn,BOOL bRedraw);//在VC6.0基於對話框時候，該函式是這樣的，有兩個參數
參數
hWnd
[in] Handle to the window whose window region is to be set.
hRgn
[in] Handle to a region. The function sets the window region of the window to this region.
If hRgn is NULL, the function sets the window region to NULL.
bRedraw
[in] Specifies whether the system redraws the window after setting the window region. If bRedraw is TRUE, the system does so; otherwise, it does not.
Typically, you set bRedraw to TRUE if the window is visible.
返回值
If the function succeeds, the return value is nonzero.
If the function fails, the return value is zero.
Windows NT/2000/XP: To get extended error information, call GetLastError.
說明
When this function is called, the system sends the WM_WINDOWPOSCHANGING and WM_WINDOWPOSCHANGED messages to the window.
The coordinates of a window's window region are relative to the upper-left corner of the window, not the client area of the window.
After a successful call to SetWindowRgn, the system owns the region specified by the region handle hRgn. The system does not make a copy of the region. Thus, you should not make any further function calls with this region handle. In particular, do not delete this region handle. The system deletes the region handle when it no longer needed.
To obtain the window region of a window, call the GetWindowRgn function.
系統要求
Windows NT/2000/XP: Included in Windows NT 3.51 and later.
Windows 95/98/Me: Included in Windows 95 and later.
Header: declared in Winuser.h; include Windows.h.
Library: Use User32.lib.
SetWindowRgn
SetWindowRgn 函式
SetWindowRgn 函式設定某一視窗的特定區域（視窗區域）。 這一區域決定了該視窗中系統可以畫圖的範圍。 系統不顯示該視窗這一區域之外的任何部分。
定義
int SetWindowRgn;(HWND hWnd, HRGN hRgn, BOOL bRedraw)
參數
hWnd
[在] 將被設定視窗區域的某一視窗的柄。
hRgn
[在] 視窗區域的句柄。 函式將窗戶的窗戶區域設定為這一個區域。
如果 hRgn 是無效力的，函式將視窗區域設定為零。
bRedraw
[在] 敘述系統是否在設定窗戶區域之後重劃視窗。 如果 bRedraw 是真實的，系統這么做; 另外，它不。
典型地, 你設定 bRedraw 到真實的如果視窗是看得見的。
返回值
如果函式調用成功，回返價值是非零。
如果函式調用失敗，回返價值是零。
windows NT/2000/XP: 得到廣大的錯誤數據,呼叫 GetLastError 。
說明
當這調用被呼叫的時候，系統把給視窗的訊息送給 WM_WINDOWPOSCHANGING 和 WM_WINDOWPOSCHANGED 。
一個窗戶的視窗區域的坐標相對於視窗的上面-左邊角落而不是視窗的客戶區域。
調用成功之後，對 SetWindowRgn ，系統擁有被區域柄 hRgn 指定的區域。 系統不作區域的副本。 因此，你不應該用這一個區域柄來做任何的較進一步的方法調用。 尤其，不要刪除這一個區域句柄。 當它不再需要的時候，系統劃除這一區域句柄。
為了要獲得視窗的視窗區域，調用 GetWindowRgn 函式。
系統要求
windows NT/2000/XP: windows NT 3.51 和後續版本。
windows 95/98/me: windows 95 和後續版本。
頭檔案: 在 Winuser.h 聲明; 包括 Windows.h 。
Library: 使用 User32. lib。