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 會捨棄先前待處理的路徑
// Draw a filled blue triangle with a 2-pt black outline
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;
// Draw a red filled rectangle using the 4-coordinate overload
Pdf1.CreatePath(50, 400, 200, 80, fmWinding, clRed);
Pdf1.AddPath;