AddLineAnnotation

註解與熱點連結

描述

在所選頁面的兩個端點之間加入線段標記註解（PDF /Subtype /Line）。兩端可各自使用不同的端點樣式（箭頭、方塊、圓、菱形、…），線身可用任意 RGB 顏色繪製並設定不透明度。有內部的端點裝飾（ClosedArrow、Square、Circle、Diamond）可選擇填色。由於此進入點會寫出 PDF 1.4 的註解 /CA 不透明度鍵，程式庫會在儲存前把較低且未鎖定的文件提升到 PDF 1.4；已鎖定的較低版本會被相容性閘門拒絕。定義於 ISO 32000-1 §12.5.6.7

語法

Delphi

Function TPDFlib.AddLineAnnotation(StartLeft, StartTop, EndLeft, EndTop: Double; BorderWidth: Double; LineRed, LineGreen, LineBlue: Double; StartStyle, EndStyle: Integer; Filled: Integer; FillRed, FillGreen, FillBlue: Double; Const Title, Contents: WideString; Transparency: Integer): Integer;

參數

StartLeft、StartTop — 直線起點端點的座標，以目前單位計

EndLeft、EndTop — 直線終點端點的座標，以目前單位計

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 閱讀器要求邊界 /Rect 必須涵蓋全部可見繪製內容，否則端點裝飾可能被裁掉

PDF 規格描述的選配進階欄位 — /LL（引線長度）、/LLE、/LLO、/Cap、/CP、/CO 與 /Measure — 不會由此進入點寫出。建立後可直接寫進註解字典補上

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