selectClipPath 函数 (wingdi.h)

SelectClipPath 函数选择当前路径作为设备上下文的剪切区域,使用指定模式将新区域与任何现有剪辑区域组合在一起。

语法

BOOL SelectClipPath(
  [in] HDC hdc,
  [in] int mode
);

参数

[in] hdc

路径的设备上下文的句柄。

[in] mode

使用路径的方式。 此参数的取值可为下列值之一:

含义
RGN_AND
新剪切区域包括当前剪切区域和当前路径的交集(重叠区域)。
RGN_COPY
新剪切区域是当前路径。
RGN_DIFF
新的剪切区域包括当前剪切区域的区域,其中排除了当前路径的区域。
RGN_OR
新剪切区域包括当前剪切区域和当前路径的并集(合并区域)。
RGN_XOR
新的剪切区域包括当前剪切区域和当前路径的并集,但不包含重叠区域。

返回值

如果该函数成功,则返回值为非零值。

如果函数失败,则返回值为零。

注解

hdc 参数标识的设备上下文必须包含一个封闭路径。

示例

有关示例,请参阅 使用剪辑

要求

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

另请参阅

BeginPath

剪裁函数

剪辑概述

EndPath