procedure CreatePath(X, Y: Single; FillMode: TPdfFillMode = fmNone; FillColor: TColor = clBlack; FillAlpha: Byte = $FF; Stroke: Boolean = True; StrokeColor: TColor = clBlack; StrokeAlpha: Byte = $FF; StrokeWidth: Single = 1.0; LineCap: TPdfLineCap = lcDefault; LineJoin: TPdfLineJoin = ljDefault; BlendMode: TPdfBlendMode = bmDefault);
| FillMode | TPdfFillMode。路径内部的填充规则:fmNone(不填充)、fmAlternate(奇偶规则)或 fmWinding(非零环绕规则)。默认值为 fmNone |
| FillColor | TColor。当 FillMode 不是 fmNone 时应用的填充颜色。默认值为 clBlack |
| FillAlpha | Byte。填充的不透明度,$00 为完全透明,$FF 为完全不透明。默认值为 $FF |
| Stroke | Boolean。为 True 时,使用 StrokeColor、StrokeAlpha 和 StrokeWidth 绘制路径轮廓。默认值为 True |
| StrokeColor | TColor。路径轮廓的颜色。默认值为 clBlack |
| StrokeAlpha | Byte。描边的不透明度,$00 为完全透明,$FF 为完全不透明。默认值为 $FF |
| StrokeWidth | Single。以 PDF 用户单位(点)计的描边线宽。默认值为 1.0 |
| LineCap | TPdfLineCap。应用于开放路径端点的样式:lcDefault、lcButt、lcRound 或 lcProjectingSquare。默认值为 lcDefault |
| LineJoin | TPdfLineJoin。应用于路径段连接处的样式:ljDefault、ljMiter、ljRound 或 ljBevel。默认值为 ljDefault |
| BlendMode | TPdfBlendMode。路径对象的合成混合模式。默认值为 bmDefault,它按 bmNormal 合成 |
procedure CreatePath(X, Y, Width, Height: Single; FillMode: TPdfFillMode = fmNone; FillColor: TColor = clBlack; FillAlpha: Byte = $FF; Stroke: Boolean = True; StrokeColor: TColor = clBlack; StrokeAlpha: Byte = $FF; StrokeWidth: Single = 1.0; LineCap: TPdfLineCap = lcDefault; LineJoin: TPdfLineJoin = ljDefault; BlendMode: TPdfBlendMode = bmDefault);
| FillMode | TPdfFillMode。矩形内部的填充规则。默认值为 fmNone |
| FillColor | TColor。矩形的填充颜色。默认值为 clBlack |
| FillAlpha | Byte。填充的不透明度($00–$FF)。默认值为 $FF |
| Stroke | Boolean。为 True 时绘制矩形轮廓。默认值为 True |
| StrokeColor | TColor。矩形轮廓的颜色。默认值为 clBlack |
| StrokeAlpha | Byte。描边的不透明度($00–$FF)。默认值为 $FF |
| StrokeWidth | Single。以点计的轮廓描边宽度。默认值为 1.0 |
| LineCap | TPdfLineCap。矩形拐角处的线帽样式。默认值为 lcDefault |
| LineJoin | TPdfLineJoin。矩形拐角处的线连接样式。默认值为 ljDefault |
| BlendMode | TPdfBlendMode。合成混合模式。默认值为 bmDefault |
CreatePath 开始构建一个新的矢量路径对象。它必须在任何路径构建方法(MoveTo、LineTo、BezierTo、ClosePath)之前调用,并且该序列必须以调用 AddPath 结束,将路径提交到当前页面
有两个可用的重载。双坐标形式 CreatePath(X, Y, ...) 初始化一个空路径,其当前点位于 (X, Y);随后可以使用路径段方法自由构建形状。四坐标形式 CreatePath(X, Y, Width, Height, ...) 直接创建一条闭合的矩形路径 — 在 AddPath 之前无需额外的路径段调用
路径的所有视觉属性 — 填充颜色与规则、描边颜色、宽度、不透明度、线帽、线连接和混合模式 — 都在创建时通过可选参数设置。默认值生成一条 1 点黑色描边且无填充的轮廓
同一时间只能构建一条路径。在 AddPath 之前再次调用 CreatePath 会丢弃先前挂起的路径
// 绘制一个带 2 磅黑色轮廓的蓝色填充三角形
Pdf1.NewPage(595, 842);
Pdf1.CreatePath(100, 100, fmWinding, clBlue, $FF, True, clBlack, $FF, 2.0);
Pdf1.LineTo(200, 300);
Pdf1.LineTo(300, 100);
Pdf1.ClosePath;
Pdf1.AddPath;
// 使用 4 坐标重载绘制一个红色填充矩形
Pdf1.CreatePath(50, 400, 200, 80, fmWinding, clRed);
Pdf1.AddPath;