ClosePath

向量圖形、路徑定義與繪製

描述

關閉 StartPath 所開始路徑的目前子路徑。會從目前點畫一條直線回到路徑起點，確保圖形成為單一閉合形狀，而不是只靠轉角接續的兩個端點。呼叫 ClosePath 並不會繪製路徑 — 之後請呼叫 DrawPath 或 DrawPathEvenOdd 進行框線繪製及／或填色。

語法

Delphi

Function TPDFlib.ClosePath: Integer;

ActiveX

Function PDFlib::ClosePath() As Long

DLL

int DLClosePath(int InstanceID);

傳回值

0	Failed — no document is open or no path has been started.
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