路径迭代
路径渐变笔刷对象存储颜色渐变的属性，可用于用逐渐变化的颜色填充路径的内部。
路径渐变画笔具有边界路径、边界颜色、中心点和中心颜色。 使用路径渐变画笔绘制区域时，从边界路径移动到中心点时，颜色会逐渐从边界颜色更改为中心颜色。 路径渐变笔刷对象简称为路刷 图形路径对象存储一系列线条、曲线和形状。 可以通过调用图形对象的绘制路径方法来绘制整个序列。 可以将线条、曲线和形状序列划分为图形，借助图形路径迭代器对象，可以绘制所选图形。 还可以在序列中放置标记，以便绘制路径的选定部分。 图形路径迭代器提供用于隔离图形路径对象中存储的路径的选定子集的方法。 路径由一个或多个数字组成。图形路径对象简称为路径 可以使用图形路径迭代器来隔离其中一个或多个数字。 路径还可以具有将路径划分为多个部分的标记。 可以使用图形路径迭代器对象来隔离其中一个或多个部分。图形路径迭代器对象简称为迭代| 中文名称 | 英文名称 | 示例 | 作用 |
| 路刷创建 | GdipCreatePathGradient | 路刷创建(点组,数量,模式,@路刷) | 基于小数坐标点数组创建路径渐变笔刷对象。初始化路径渐变画笔的环绕模式。 |
| 路刷新建 | GdipCreatePathGradientI | 路刷新建(点组,数量,模式,@路刷) | 基于整数坐标点数组创建路径渐变笔刷对象。初始化路径渐变画笔的环绕模式。 |
| 路径变刷 | GdipCreatePathGradientFromPath | 路径变刷(路径,@路刷) | 基于路径对象创建路径渐变笔刷对象。 |
| 路取中色 | GdipGetPathGradientCenterColor | 路取中色(路刷,@颜色) | 获取此路径渐变画笔的中心点的颜色。 |
| 路改中色 | GdipSetPathGradientCenterColor | 路改中色(路刷,颜色) | 设置此路径渐变画笔的中心点的颜色。 |
| 路取边色 | GdipGetPathGradientSurroundColorsWithCount | 路取边色(路刷,@颜色组,@组数) | 获取此路径渐变画笔的中心点的颜色。 |
| 路改边色 | GdipGetPathGradientSurroundColorsWithCount | 路改边色(路刷,颜色组,@组数) | 设置此路径渐变画笔的中心点的颜色。 |
| 路取中心 | GdipGetPathGradientCenterPoint | 路取中心(路刷,@点组) | 获取此路径渐变画笔的小数值中心点。 |
| 路改中心 | GdipSetPathGradientCenterPoint | 路改中心(路刷,点组) | 设置此路径渐变画笔的小数值中心点。 |
| 路取中点 | GdipGetPathGradientCenterPointI | 路取中点(路刷,@点组) | 获取此路径渐变画笔的整数值中心点。 |
| 路改中点 | GdipSetPathGradientCenterPointI | 路改中点(路刷,点组) | 设置此路径渐变画笔的整数值中心点。 |
| 路刷边界 | GdipGetPathGradientRect | 路刷边界(路刷,@点组) | 获取包含此路径渐变画笔的边界路径的最小矩形。 |
| 路刷矩形 | GdipGetPathGradientRectI | 路刷矩形(路刷,点组) | 获取包含此路径渐变画笔的边界路径的最小矩形。 |
| 路刷点数 | GdipGetPathGradientPointCount | 路刷点数(路刷,@点组) | 获取定义此画笔边界路径的点数组中的点数。 |
| 路边色数 | GdipGetPathGradientSurroundColorCount | 路边色数(路刷,@数量) | 获取已为此路径渐变画笔的边界路径指定的颜色数。 |
| 路取校正 | GdipGetPathGradientGammaCorrection | 路取校正(路刷,@是否) | 确定是否为此路径渐变画笔启用伽玛校正。 |
| 路改校正 | GdipSetPathGradientGammaCorrection | 路改校正(路刷,是否) | 指定是否为此路径渐变画笔启用伽玛校正。 |
| 路刷因数 | GdipGetPathGradientBlendCount | 路刷因数(路刷,@数量) | 获取当前为此路径渐变画笔设置的混合因子数。 |
| 路取混合 | GdipGetPathGradientBlend | 路取混合(路刷,@因子,@点组,数量) | 获取当前为此路径渐变画笔设置的混合因子和相应的混合位置。 |
| 路改混合 | GdipSetPathGradientBlend | 路改混合(路刷,因子,点组,数量) | 设置此路径渐变画笔的混合因子和混合位置。 |
| 路颜色数 | GdipGetPathGradientPresetBlendCount | 路颜色数(路刷,@数量) | 获取当前为此路径渐变画笔指定的预设颜色数。 |
| 路取混色 | GdipGetPathGradientPresetBlend | 路取混色(路刷,@色组,@点组,数量) | 获取当前为此路径渐变画笔设置的混合因子和相应的混合位置。 |
| 路改混色 | GdipSetPathGradientPresetBlend | 路改混色(路刷,色组,点组,数量) | 设置此路径渐变画笔的预设颜色和混合位置。 |
| 路混原形 | GdipSetPathGradientSigmaBlend | 路混原形(路刷,中心强度,边界强度) | 设置此路径渐变画笔的混合形状。 |
| 路混线性 | GdipSetPathGradientLinearBlend | 路混线性(路刷,中心强度,边界强度) | 设置此路径渐变画笔的混合形状。 |
| 路改平铺 | GdipSetPathGradientWrapMode | 路改平铺(路刷,模式) | 设置此路径线性渐变画笔的环绕模式。 |
| 路取平铺 | GdipGetPathGradientWrapMode | 路取平铺(路刷,@模式) | 获取此路径线性渐变画笔的换行模式。确定如何平铺区域。 |
| 路取转矩 | GdipGetPathGradientTransform | 路取转矩(路刷,@矩阵) | 获取此路径线性渐变画笔的转换矩阵。 |
| 路改转矩 | GdipSetPathGradientTransform | 路改转矩(路刷,矩阵) | 设置此路径线性渐变画笔的转换矩阵。 |
| 路刷标识 | GdipResetPathGradientTransform | 路刷标识(路刷,@矩阵) | 将此路径线性渐变画笔的转换矩阵重置为标识矩阵。这意味着不会发生任何转换。 |
| 路乘矩阵 | GdipMultiplyPathGradientTransform | 路乘矩阵(路刷,矩阵,顺序) | 使用自身和另一个矩阵的乘积更新此线刷对象的世界转换矩阵。乘法顺序:0新矩阵在左侧,1在右侧 |
| 路乘转换 | GdipTranslatePathGradientTransform | 路乘转换(路刷,平缩,纵缩,顺序) | 此路径线性渐变画刷对象的世界转换矩阵设置为等于自身和转换矩阵的乘积。乘法顺序:0新矩阵在左侧,1在右侧 |
| 路乘缩放 | GdipScalePathGradientTransform | 路乘缩放(路刷,横缩,纵缩,顺序) | 此路径线性渐变画刷对象的世界转换矩阵设置为等于自身和缩放矩阵的乘积。乘法顺序:0新矩阵在左侧,1在右侧 |
| 路乘旋转 | GdipRotatePathGradientTransform | 路乘旋转(路刷,小数 角度,顺序) | 使用自身乘积和旋转矩阵更新此线刷对象的世界转换矩阵。乘法顺序:0新矩阵在左侧,1在右侧 |
| 路取比例 | GdipGetPathGradientFocusScales | 路取比例(路刷,@横比,@纵比) | 获取此路径渐变画笔的焦点比例。 |
| 路改比例 | GdipSetPathGradientFocusScales | 路改比例(路刷,横比,纵比) | 设置此路径渐变画笔的焦点比例。 |
| 路径创建 | GdipCreatePath | 路径创建(模式,@路径) | 创建路径对象并初始化填充模式。这是默认构造函数。 |
| 路径新建 | GdipCreatePath2 | 路径新建(点组,类组,数量,模式,@路径) | 基于小数值点数组、类型字节数组和填充模式创建路径对象。 |
| 路径建立 | GdipCreatePath2I | 路径建立(点组,类组,数量,模式,@路径) | 基于整数值点数组、类型字节数组和填充模式创建路径对象。 |
| 路径克隆 | GdipClonePath | 路径克隆(路径,@新路径) | 创建新的路径对象，并使用此路径对象的内容对其进行初始化。 |
| 路径删除 | GdipDeletePath | 路径删除(路径) | 释放路径对象使用的资源。 |
| 路径重置 | GdipResetPath | 路径重置(路径) | 清空路径并将填充模式设置为0奇偶交替。 |
| 路径点数 | GdipGetPointCount | 路径点数(路径,@数量) | 获取此路径的数据点数组中的点数。这与路径的点类型数组中的类型数相同。 |
| 路径类型 | GdipGetPathTypes | 路径类型(路径,@类型组,数量) | 获取此路径的点类型的字节数组。 |
| 路径点组 | GdipGetPathPoints | 路径点组(路径,@点组,数量) | 获取此路径的小数值点数组。包含用于绘制路径的线条和贝塞尔样条的端点和控制点。 |
| 路径点集 | GdipGetPathPointsI | 路径点集(路径,@点组,数量) | 获取此路径的整数值点数组。包含用于绘制路径的线条和贝塞尔样条的端点和控制点。 |
| 路取填充 | GdipGetPathFillMode | 路取填充(路径,@模式) | 获取此路径的填充模式。 |
| 路改填充 | GdipSetPathFillMode | 路改填充(路径,模式) | 设置此路径的填充模式。 |
| 路径数据 | GdipGetPathData | 路径数据(路径,路径数据类) | 从此路径获取点数组和点类型的数组。路径点类的两个数组一起定义此路径的线条、曲线、图形和标记。 |
| 路开新图 | GdipStartPathFigure | 路开新图(路径) | 不闭合当前图形即开始一个新图形。添加到此路径的后续点将添加到新图中。 |
| 路关现图 | GdipClosePathFigure | 路关现图(路径) | 关闭此路径的当前图。 |
| 路关全图 | GdipClosePathFigures | 路关全图(路径) | 关闭此路径中的所有打开的图形。 |
| 路径标记 | GdipSetPathMarker | 路径标记(路径) | 将此路径中的最后一个点指定为标记点。 |
| 路清标识 | GdipClearPathMarkers | 路清标识(路径) | 清除此路径中的标记。 |
| 路径反转 | GdipReversePath | 路径反转(路径) | 反转定义此路径的线条和曲线的点的顺序。 |
| 路径终点 | GdipGetPathLastPoint | 路径终点(路径,@终点) | 获取此路径中最后一个图形的终点。 |
| 路加线段 | GdipAddPathLine | 路加线段(路径,左,上,右,下) | 向此路径的当前图形添加一条线段。 |
| 路加多线 | GdipAddPathLine2 | 路加多线(路径,点组,数量) | 向此路径的当前图形添加多条线段。 |
| 路加圆弧 | GdipAddPathArc | 路加圆弧(路径,左,顶,宽,高,起始角,扫视角) | 向此路径的当前图形添加椭圆弧。 |
| 路加曲线 | GdipAddPathBezier | 路加曲线(路径,x1,y1,x2,y2,x3,y3,x4,y4) | 向此路径的当前图形添加贝塞尔样条。 |
| 路多曲线 | GdipAddPathBeziers | 路多曲线(路径,点组,数量) | 向此路径的当前图形添加一系列贝塞尔样条。 |
| 路加弧线 | GdipAddPathCurve | 路加弧线(路径,点组,数量) | 将基数样条添加到此路径的当前图形。 |
| 路加弧度 | GdipAddPathCurve2 | 路加弧度(路径,点组,数量,曲率) | 将基数样条添加到此路径的当前图形。 |
| 路加弧形 | GdipAddPathCurve3 | 路加弧形(路径,点组,组数,起始,段数,曲率) | 将基数样条添加到此路径的当前图形。 |
| 路加封闭 | GdipAddPathClosedCurve | 路加封闭(路径,点组,组数) | 将一个闭合的基数样条添加到此路径。 |
| 路加闭合 | GdipAddPathClosedCurve2 | 路加闭合(路径,点组,组数,曲率) | 将一个闭合的基数样条添加到此路径。 |
| 路加矩形 | GdipAddPathRectangle | 路加矩形(路径,点组,组数) | 将一个矩形添加到此路径。 |
| 路加方组 | GdipAddPathRectangles | 路加方组(路径,点组,组数,曲率) | 将多个矩形添加到此路径。 |
| 路加椭圆 | GdipAddPathEllipse | 路加椭圆(路径,左,顶,宽,高) | 将一个椭圆添加到此路径。 |
| 路加饼图 | GdipAddPathPie | 路加饼图(路径,左,顶,宽,高,起始角,扫视角) | 将一个饼图添加到此路径。 |
| 路加多边 | GdipAddPathPolygon | 路加多边(路径,点组,组数) | 将一个多边形添加到此路径。 |
| 路加路径 | GdipAddPathPath | 路加路径(路径,路径,合并) | 将一个路径添加到此路径。合并为真时原图是新图形的一部分 |
| 路加轮廓 | GdipAddPathString | 路加轮廓(路径,宽字,长度,字系,字样,字高,边框,字形) | 将字符串的轮廓添加到此路径。边框矩形为小数,字高为小数世界单位;字样 |
| 路字轮廓 | GdipAddPathStringI | 路字轮廓(路径,宽字,长度,字系,字样,字高,边框,字形) | 将字符串的轮廓添加到此路径。边框矩形为整数,字高为小数世界单位;字样 |
| 路径线段 | GdipAddPathLineI | 路径线段(路径,左,上,右,下) | 向此路径的当前图形添加一条线段。 |
| 路径多线 | GdipAddPathLine2I | 路径多线(路径,点组,数量) | 向此路径的当前图形添加多条线段。 |
| 路径圆弧 | GdipAddPathArcI | 路径圆弧(路径,左,顶,宽,高,起始角,扫视角) | 向此路径的当前图形添加椭圆弧。 |
| 路径曲线 | GdipAddPathBezierI | 路径曲线(路径,x1,y1,x2,y2,x3,y3,x4,y4) | 向此路径的当前图形添加贝塞尔样条。 |
| 路径曲组 | GdipAddPathBeziersI | 路径曲组(路径,点组,数量) | 向此路径的当前图形添加一系列贝塞尔样条。 |
| 路径弧线 | GdipAddPathCurveI | 路径弧线(路径,点组,数量) | 将基数样条添加到此路径的当前图形。 |
| 路径弧度 | GdipAddPathCurve2I | 路径弧度(路径,点组,数量,曲率) | 将基数样条添加到此路径的当前图形。 |
| 路径弧形 | GdipAddPathCurve3I | 路径弧形(路径,点组,组数,起始,段数,曲率) | 将基数样条添加到此路径的当前图形。 |
| 路径闭合 | GdipAddPathClosedCurveI | 路径闭合(路径,点组,组数) | 将一个闭合的基数样条添加到此路径。 |
| 路径闭弧 | GdipAddPathClosedCurve2I | 路径闭弧(路径,点组,组数,曲率) | 将一个闭合的基数样条添加到此路径。 |
| 路径矩形 | GdipAddPathRectangleI | 路径矩形(路径,点组,组数) | 将一个矩形添加到此路径。 |
| 路径方组 | GdipAddPathRectanglesI | 路径方组(路径,点组,组数,曲率) | 将多个矩形添加到此路径。 |
| 路径椭圆 | GdipAddPathEllipseI | 路径椭圆(路径,左,顶,宽,高) | 将一个椭圆添加到此路径。 |
| 路径饼图 | GdipAddPathPieI | 路径饼图(路径,左,顶,宽,高,起始角,扫视角) | 将一个饼图添加到此路径。 |
| 路径多边 | GdipAddPathPolygonI | 路径多边(路径,点组,组数) | 将一个多边形添加到此路径。 |
| 路径平展 | GdipFlattenPath | 路径平展(路径,矩阵,平整度) | 将转换应用于此路径，并将路径中的每个曲线转换为连接的线条序列。 |
| 路径卷边 | GdipWindingModeOutline | 路径卷边(路径,矩阵,平整度) | 转换和平展此路径，然后转换此路径的数据点，以便它们仅表示路径的轮廓。 |
| 路径扩展 | GdipWidenPath | 路径扩展(路径,笔,矩阵,平整度) | 将此路径替换为包含指定笔绘制此路径时所填充区域的曲线。此方法还会平展路径。 |
| 路径扭曲 | GdipWarpPath | 路径扭曲(路径,矩阵,点组,数组,左,顶,宽,高,平整度) | 将扭曲转换应用于此路径。此方法还会平展 (转换为路径) 直线序列。 |
| 路径转换 | GdipTransformPath | 路径转换(路径,矩阵) | 将此路径的每个数据点乘以指定的矩阵。 |
| 路径边框 | GdipGetPathWorldBounds | 路径边框(路径,@边框,矩阵,笔) | 获取此路径的小数值边框矩形。 |
| 路径外框 | GdipGetPathWorldBoundsI | 路径外框(路径,@边框,矩阵,笔) | 获取此路径的整数值边框矩形。 |
| 路径区点 | GdipIsVisiblePathPoint | 路径区点(路径,左,上,图形,@是否) | 确定指定小数值点是否位于由指定的图形设备对象填充此路径时所填充的区域。 |
| 路径内点 | GdipIsVisiblePathPointI | 路径内点(路径,左,上,图形,@是否) | 确定指定整数值点是否位于由指定的图形设备对象填充此路径时所填充的区域。 |
| 路径边线 | GdipIsOutlineVisiblePathPoint | 路径边线(路径,左,上,笔,图形,@是否) | 确定当路径由指定的图形设备对象和指定的笔绘制时，指定的点是否触及此路径的轮廓。 |
| 路径边界 | GdipIsOutlineVisiblePathPoint | 路径迭代(路径,左,上,笔,图形,@是否) | 确定当路径由指定的图形设备对象和指定的笔绘制时，指定的点是否触及此路径的轮廓。 |
| 路径迭代 | GdipCreatePathIter | 路径迭代(@迭代,路径) | 创建新的迭代器对象，并将其与 路径 对象相关联。 |
| 删除迭代 | GdipDeletePathIter | 删除迭代(迭代) | 释放迭代器对象使用的资源。 |
| 迭代索引 | GdipPathIterNextSubpath | 迭代索引(迭代,@结果,@起始,@结束,@闭合) | 获取此迭代器的关联路径中下一个子路径(图)的起始索引和结束索引。 |
| 迭代子路 | GdipPathIterNextSubpath | 迭代子路(迭代,@结果,@路径,@闭合) | 从此迭代器的关联路径获取下一个图 (子路径) 。 |
| 迭代同类 | GdipPathIterNextPathType | 迭代同类(迭代,@结果,@起始,@结束,@闭合) | 获取全部具有相同类型的下一组数据点的起始索引和结束索引。 |
| 迭代标记 | GdipPathIterNextMarker | 迭代标记(迭代,@结果,@起始,@结束) | 获取此迭代器的关联路径中下一个标记分隔节的起始索引和结束索引。 |
| 迭代记路 | GdipPathIterNextMarkerPath | 迭代记路(迭代,@结果,@路径) | 获取此迭代器的关联路径的下一个标记分隔部分。 |
| 迭代点数 | GdipPathIterGetCount | 迭代点数(迭代,@点数) | 返回路径中的数据点数。 |
| 迭代数目 | GdipPathIterGetSubpathCount | 迭代数目(迭代,@数目) | 返回路径中子路径的数目。 |
| 迭代有效 | GdipPathIterIsValid | 迭代有效(迭代,@是否) | 指示迭代器参数指定的路径迭代器是否有效。 |
| 迭代曲线 | GdipPathIterHasCurve | 迭代曲线(迭代,@是否) | 确定路径是否具有任何曲线。 |
| 迭代倒放 | GdipPathIterRewind | 迭代倒放(迭代) | 将此迭代器倒带到其关联路径的开头。 |
| 迭代枚举 | GdipPathIterEnumerate | 迭代枚举(迭代,@结果,@点组,@类组,数量) | 将路径的数据点复制到小数值点数组，并将路径的点类型复制到字节数组。 |
| 迭代数据 | GdipPathIterCopyData | 迭代数据(迭代,@结果,@点组,@类组,起始,结束) | 将路径数据点的子集复制到小数值点数组，并将路径的点类型的子集复制到字节数组。 |
路径点类型PathPointType 路径中数据点的点类型和标志。0到2位指定点的类型，3到7位指定点属性的标志。
| 中文名称 | 英文名称 | 数值 | 作用 |
| 路点开头 | PathPointTypeStart | 0 | 指示该点是图形的开头。 |
| 路点线段 | PathPointTypeLine | 1 | 指示该点是线条的两个端点之一。 |
| 贝塞尔点 | PathPointTypeBezier | 3 | 指示该点是三次方贝塞尔样条的端点或控制点。 |
| 路点掩码 | PathPointTypePathTypeMask | 0x07 | 掩码除三个低序位（指示点类型）之外的所有位。 |
| 路点虚线 | PathPointTypeDashMode | 0x10 | 未使用。 |
| 路点标记 | PathPointTypePathMarker | 0x20 | 指定该点为标记。 |
| 路点终点 | PathPointTypeCloseSubpath | 0x80 | 指定该点是封闭的子路径中的最后一个点(图) 。 |
路径点类
| 中文名字 | 英文名称 | 长度 | 作用解释 |
| 路径点类 | PathData | 12 | 具有一个点数组和一个类型的数组。 |
| 路径点类——成员表 | |||
|---|---|---|---|
| 数量 | count | 整数 | 数组元素的数量。 |
| 点组 | Points | 整数 | 指向小数坐标点数组的指针 |
| 类组 | types | 整数 | 指向点类型数组的指针。类型数组中的每个元素都是一个字节，用于指定点类型和点数组中对应元素的一组标志。 |