描述
SelectClipPath功能将当前路径选择为设备上下文的剪切区域,使用指定的模式将新区域与任何现有的剪切区域组合。
C++ 语法
BOOL SelectClipPath( __in HDC hdc, __in int iMode ); |
PowerBASIC 语法
FUNCTION SelectClipPath ( _ BYVAL hdc AS DWORD, _ BYVAL iMode AS LONG _ ) AS LONG |
参数
hdc
[in]处理设备上下文。
iMode
[in]指定要执行的操作。它必须是以下值之一。
值 |
含义 |
RGN_AND |
新的剪辑区域包括当前剪辑区域和当前路径的交点(重叠区域)。 |
RGN_COPY |
新剪辑区域是当前路径。 |
RGN_DIFF |
新的剪切区域包括当前剪辑区域与当前路径排除的区域。 |
RGN_OR |
新的剪辑区域包括当前剪辑区域和当前路径的联合(组合区域)。 |
RGN_XOR |
新的剪辑区域包括当前剪辑区域和当前路径的并集,但没有重叠区域。 |
返回值
如果函数成功,返回值不为零。
如果函数失败,返回值为零。
Windows NT / 2000 / XP / Vista / Windows 7:要获取扩展错误信息,请调用GetLastError.GetLastError可能会返回以下错误代码之一:
ERROR_CAN_NOT_COMPLETE
ERROR_INVALID_PARAMETER
ERROR_NOT_ENOUGH_MEMORY
备注
由hDC参数标识的设备上下文必须包含封闭路径。
引用文件 #INCLUDE Once
WinGdi.inc(包括Windows.inc)