• 文档 /
  • GetClipRgn-检索标识指定设备上下文的当前应用程序定义的剪切区域的句柄

平台 SDK: Windows GDI

GetClipRgn

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

int GetClipRgn(
  HDC hdc,           // 设备上下文句柄
  HRGN hrgn          // 区域句柄
);

参数

  • hdc

  • [in] 设备上下文句柄。

  • hrgn

  • [in] 在函数调用之前处理到现有区域句柄。 函数返回后,此参数是当前剪切区域的副本的句柄。

返回值


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

Windows NT/2000/XP: 要获取扩展错误信息,请调用GetLastError

备注


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

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

要求

   Windows NT / 2000 / XP:包含在Windows NT 3.1及更高版本中。

   Windows 95/98 / Me:包含在Windows 95及更高版本中。

   头文件:声明于Wingdi.h; 包含于Windows.h。

   库:使用Gdi32.lib。