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。