勇芳软件工作室.汉化:  Painting and Drawing > Painting and Drawing Functions >

SetWindowRgn

Previous pageReturn to chapter overviewNext page

描述

 

SetWindowRgn函数设置窗口的窗口区域。窗口区域确定系统允许绘制的窗口内的区域。系统不显示位于窗口区域之外的窗口的任何部分

 

C++ 语法

 

int SetWindowRgn(

__in HWND hWnd,

__in HRGN hRgn,

__in BOOL bRedraw

);

 

PowerBASIC 语法

 

FUNCTION SetWindowRgn ( _

BYVAL hWnd AS DWORD, _

BYVAL hRgn AS DWORD, _

BYVAL bRedraw AS LONG _

) AS LONG

 

参数

 

hWnd

 

[in]处理要设置窗口区域的窗口。

 

hRgn

 

[in]处理某个地区。该函数将窗口的窗口区域设置为该区域。

 

如果HRGN为NULL,则该函数将窗口区域设置为NULL。

 

bRedraw

 

[in]指定在设置窗口区域后系统是否重新绘制窗口。如果bRedraw为TRUE,系统会这样做;否则,它不。

 

通常,如果窗口可见,则将bRedraw设置为TRUE。

 

返回值

 

如果函数成功,返回值不为零。

 

如果函数失败,返回值为零。

 

备注

 

当调用此函数时,系统会将WM_WINDOWPOSCHANGINGWM_WINDOWPOSCHANGED消息发送到窗口。

 

窗口的窗口区域的坐标相对于窗口的左上角,而不是窗口的客户区域。

 

成功调用SetWindowRgn后,系统拥有区域句柄HRGN指定的区域。系统不会制作该地区的副本。因此,您不应该使用此区域句柄进行任何进一步的函数调用。特别是不要删除这个区域句柄。当不再需要时,系统会删除区域句柄。

 

要获取窗口的窗口区域,请调用GetWindowRgn函数。

 

引用文件 #INCLUDE Once

 

WinUser.inc(包括Windows.inc)