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)
Library User32.lib
DLL User32.dll
API 集 ext-ms-win-ntuser-draw-l1-1-2 (在 Windows 10 版本 10.0.10240 中引入)

另请参阅

绘制和绘制函数

绘画和绘图概述

SetWindowRgn