勇芳软件工作室.汉化:  Clipping > Clipping Functions >

SelectClipPath

Previous pageReturn to chapter overviewNext page

描述

 

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)