AddPolyLineAnnotation

註解與熱點連結

描述

以提供的頂點清單，在所選頁面加入開放折線標記註解（PDF /Subtype /PolyLine）。折線是開放的——閱讀器不會把最後一個頂點連回第一個——兩個端點可各自使用不同的端點樣式。有內部的端點裝飾（ClosedArrow、Square、Circle、Diamond）可選擇填色。顏色成分與不透明度以 0–1 表示；Transparency 以 0–100 表示（0 = 完全不透明，100 = 完全透明）。在較低的最低版本鎖定下輸出 PolyLine 註解時，程式庫會把文件版本提升到 PDF 1.5。定義於 ISO 32000-1 §12.5.6.9

語法

Delphi

Function TPDFlib.AddPolyLineAnnotation(Const VertexCoords: WideString; BorderWidth: Double; LineRed, LineGreen, LineBlue: Double; StartStyle, EndStyle: Integer; Filled: Integer; FillRed, FillGreen, FillBlue: Double; Const Title, Contents: WideString; Transparency: Integer): Integer;

參數

VertexCoords — 頂點座標為單一字串，x/y 值交錯排列，以空格、逗號、分號或 tab 分隔。例如 "100,100,200,100,200,200"。數值個數為奇數或不足三對時，以 0 拒絕。

BorderWidth — 折線及其端點裝飾的筆劃寬度，以目前單位計

LineRed、LineGreen、LineBlue — 線條顏色的 RGB 成分（0–1），寫入 /C

StartStyle、EndStyle — 第一個與最後一個頂點各自的端點樣式。可使用：

0 = None, 1 = Square, 2 = Circle, 3 = Diamond, 4 = OpenArrow, 5 = ClosedArrow, 6 = Butt, 7 = ROpenArrow, 8 = RClosedArrow, 9 = Slash.

超出範圍的值以 0（None）夾限。

Filled — 1 表示為端點裝飾輸出內部填色（/IC），0 表示不填色

FillRed、FillGreen、FillBlue — 端點裝飾內部填色的 RGB 成分（0–1）。Filled 為 0 時忽略

Title — 寫入註解 /T 項目的作者名稱。傳入空字串可略過。

Contents — 與註解關聯的彈出視窗內文。傳入空字串可略過

Transparency — 以百分比透明度表示（0–100）。程式庫會換算成 PDF /CA = 1 - Transparency/100 並夾限到有效範圍。

傳回值

成功傳回 1；若未選取任何文件、頂點字串無法解析，或無法建立註解則傳回 0

備註

註解 /Rect 由頂點範圍加上與框線寬度成比例的邊距自動計算，讓端點裝飾保持在註解邊界框內

PDF 規格描述的選配進階欄位 — /IT（意圖，含 PolyLineDimension）與 /Measure — 不會由此進入點寫出。建立後可直接寫進註解字典補上

建立之後要覆寫線條顏色、框線、內容或矩形，請用 SetAnnotBorderColor、SetAnnotBorderStyle、SetAnnotContents 與 SetAnnotRect。