通过

extSelectClipRgn 函数 (wingdi.h)

  • 项目

ExtSelectClipRgn 函数使用指定模式将指定区域与当前剪切区域组合在一起。

语法

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

参数

[in] hdc

设备上下文的句柄。

[in] hrgn

要选择的区域的句柄。 除非指定了RGN_COPY模式，否则此句柄不得为 NULL 。

[in] mode

要执行的操作。 必须是以下值之一。

值 含义
RGN_AND
 新的剪辑区域将当前剪切区域的重叠区域与 hrgn 标识的区域组合在一起。
RGN_COPY
 新的剪辑区域是由 hrgn 标识的区域的副本。 这与 SelectClipRgn 相同。 如果 hrgn 标识的区域为 NULL，则新剪辑区域为默认剪辑区域， (默认剪辑区域为 null 区域) 。
RGN_DIFF
 新的剪辑区域将当前剪切区域的区域与 hrgn 标识的区域中排除的区域组合在一起。
RGN_OR
 新的剪辑区域将当前剪辑区域与 hrgn 标识的区域组合在一起。
RGN_XOR
 新的剪辑区域将当前剪切区域与 hrgn 标识的区域组合在一起，但不包括任何重叠区域。

返回值

返回值指定新剪辑区域的复杂性;可以是以下值之一。

返回代码 说明
NULLREGION
 区域为空。
SIMPLEREGION
 区域是单个矩形。
COMPLEXREGION
 区域是多个矩形。
ERROR
 出现了错误。

注解

如果在调用此函数时出错，则指定设备上下文的上一个剪辑区域不受影响。

ExtSelectClipRgn 函数假定指定区域的坐标以设备单位指定。

仅使用 由 hrgn 参数标识的区域的副本。 此调用后，可以重复使用区域本身，也可以将其删除。

要求

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

另请参阅

剪裁函数

剪辑概述

SelectClipRgn