ClosePath

矢量图形、路径定义和绘制

描述

关闭由 StartPath 开始的路径的当前子路径。从当前点向路径起点绘制一条直线,以确保该图形是单一闭合形状,而非仅由描边连接的两个端点。调用 ClosePath 不会绘制路径——之后请调用 DrawPath 或 DrawPathEvenOdd 进行描边和/或填充

语法

Delphi

Function TPDFlib.ClosePath: Integer;

ActiveX

Function PDFlib::ClosePath() As Long

DLL

int DLClosePath(int InstanceID);

返回值

0失败 — 未打开文档或尚未开始路径
1当前子路径已闭合

备注

需要描边形状时,闭合路径很重要:开放路径会在最后一点和第一点之间留下可见间隙,该顶点处的描边连接会渲染为平头端点而非正确的线连接,对于填充路径,填充规则隐含闭合线,但显式闭合仍可产生更干净的输出,并且在使用另一个 StartPath 开始新子路径前是必需的

示例

// Draw a closed triangle, stroked
PDF.SetStrokeColor(0, 0, 0);
PDF.SetLineWidth(1);
PDF.StartPath(100, 100);
PDF.AddLineToPath(200, 100);
PDF.AddLineToPath(150, 180);
PDF.ClosePath;          // line back to (100, 100)
PDF.DrawPath(0);        // 0 = outline only

另请参阅

StartPath、AddLineToPath、AddCurveToPath、DrawPath、DrawPathEvenOdd