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 标识的区域组合在一起，但不包括任何重叠区域。

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

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

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

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

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