AddPolygonAnnotation

註解與熱點連結

描述

以提供的頂點清單，在所選頁面加入封閉多邊形標記註解（PDF /Subtype /Polygon）。多邊形會隱含封閉——閱讀器描繪時會把最後一個頂點連回第一個。形狀可選擇以純色內部填色。顏色成分與不透明度以 0–1 表示；Transparency 以 0–100 表示（0 = 完全不透明，100 = 完全透明）。在較低的最低版本鎖定下輸出 Polygon 註解時，程式庫會把文件版本提升到 PDF 1.5。定義於 ISO 32000-1 §12.5.6.9

語法

Delphi

Function TPDFlib.AddPolygonAnnotation(Const VertexCoords: WideString; BorderWidth: Double; BorderRed, BorderGreen, BorderBlue: Double; 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 — 多邊形外框的筆劃寬度，以目前單位計

BorderRed、BorderGreen、BorderBlue — 外框顏色的 RGB 成分（0–1），寫入 /C

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 規格描述的選配進階欄位 — /BE（邊框效果，含雲朵狀外框樣式）、/IT（意圖，含 PolygonCloud 與 PolygonDimension）與 /Measure — 不會由此進入點寫出。建立後可直接寫進註解字典補上

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