AddSquareAnnotation

註解與熱點連結

Description

在所選頁面加入矩形標記註解（PDF /Subtype /Square）。註解會描繪內接於給定邊界矩形的描邊矩形，並可選擇以純色內部填色。顏色成分與不透明度以 0–1 表示；Transparency 以 0–100 表示（0 = 完全不透明，100 = 完全透明）。由於此進入點會寫出 PDF 1.4 的註解 /CA 不透明度鍵，程式庫會在儲存前把較低且未鎖定的文件提升到 PDF 1.4；已鎖定的較低版本會被相容性閘門拒絕。定義於 ISO 32000-1 §12.5.6.8

語法

Delphi

Function TPDFlib.AddSquareAnnotation(Left, Top, Width, Height: Double; BorderWidth: Double; BorderRed, BorderGreen, BorderBlue: Double; Filled: Integer; FillRed, FillGreen, FillBlue: Double; Const Title, Contents: WideString; Transparency: Integer): Integer;

參數

Left — 註解矩形左下角的水平座標，以目前單位計

Top — 註解矩形左下角的垂直座標，以目前單位計。

Width — 註解矩形的寬度。

Height — 註解矩形的高度

BorderWidth — 矩形外框的筆劃寬度，以目前單位計。同時寫入舊式的 /Border 欄位與 /BS 邊框樣式字典

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 並夾限到有效範圍。

Return Value

成功傳回 1；若未選取任何文件或無法建立註解則傳回 0

Remarks

註解輸出時帶有標準 markup 欄位組：/Type /Annot、/Subtype /Square、/Rect、/C、/IC（Filled 時）、/BS、/Border、/CA、/F = 4（可列印）、/M、/CreationDate、/NM、/T、/Contents、/Subj = "Rectangle" 與 /P。這與 Adobe Acrobat 和 Foxit 的矩形審閱工具產出一致，外部審閱流程因此能定位、編輯、留言並回覆產生的註解

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