getClipRgn 函数 (wingdi.h)

GetClipRgn 函数检索标识指定设备上下文的当前应用程序定义的剪辑区域的句柄。

语法

int GetClipRgn(
  [in] HDC  hdc,
  [in] HRGN hrgn
);

[in] hdc

设备上下文的句柄。

[in] hrgn

调用函数之前对现有区域的句柄。函数返回后，此参数是当前剪辑区域副本的句柄。

如果函数成功，并且给定设备上下文没有剪辑区域，则返回值为零。如果函数成功，并且给定设备上下文存在剪辑区域，则返回值为 1。如果发生错误，则返回值为 -1。

应用程序定义的剪辑区域是由 SelectClipRgn 函数标识的剪辑区域。它不是应用程序调用 BeginPaint 函数时创建的剪辑区域。

如果函数成功，则 hrgn 参数是当前剪辑区域副本的句柄。对此副本的后续更改不会影响当前剪辑区域。

要求	值
最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
目标平台	Windows
标头	wingdi.h (包括 Windows.h)
Library	Gdi32.lib
DLL	Gdi32.dll