勇芳软件工作室.汉化:  GDI+ Flat API > Graphics Functions >

GdipSetClipPath

Previous pageReturn to chapter overviewNext page

描述

 

将此图像对象的裁剪区域更新为自身与图形路径指定的区域的组合。如果路径中的图形未关闭,则此函数将非闭合图形视为以连接图形的起点和终点的直线关闭。

 

C++ 语法

 

GpStatus WINGDIPAPI GdipSetClipPath(

   GpGraphics *graphics,

   GpPath *path,

   CombineMode combineMode

);

 

PowerBASIC 语法

 

FUNCTION GdipSetClipPath ( _

   BYVAL graphics AS DWORD, _

   BYVAL path AS DWORD, _

   BYVAL combineMode AS LONG _

) AS LONG

 

参数

 

graphics

 

[in]指向图像对象的指针。

 

path

 

[in]指向GraphicsPath对象的指针,该对象指定要与此图像对象的裁剪区域组合的区域。

 

combinemode

 

[in]CombineMode枚举的元素,用于指定指定区域如何与此Graphics对象的裁剪区域组合。默认值为CombineModeReplace.

 

返回值

 

如果函数成功,它返回Ok,它是状态枚举的一个元素。

 

如果函数失败,它返回状态枚举的其他元素之一。

 

备注

 

该函数假设HRGN指定的GDI区域已经在设备单位中,因此不会转换GDI区域的坐标。