THotPDF.NewLoadedAnnotation Method
在已載入 PDF 檔案的指定頁面上建立一個指定子類型的註解字典,適用於向現有 PDF 附加醒目提示、連結、文字標註等各類註解
宣告
function NewLoadedAnnotation(PageIndex: Integer; const ASubtype: AnsiString; ARect: THPDFRect): THPDFDictionaryObject;
單元
HPDFDoc
參數
| 名稱 | 用途 |
|---|---|
PageIndex | 目標頁面的零起始索引,指定註解所在頁面 |
ASubtype | 註解子類型名称,如 |
Text、 | NewLoadedAnnotation 所使用的輸入 |
Link、 | NewLoadedAnnotation 所使用的輸入 |
Highlight,对应 PDF 規範中的 Subtype 鍵值 | NewLoadedAnnotation 所使用的輸入 |
ARect | 註解在頁面上的位置與尺寸矩形,使用 PDF 座標系(原點位於頁面左下角) |
傳回值
傳回代表新建注释的
使用注意事項
- 新建註解會被自動註冊到目標頁面的 Annots 陣列,無需手動將其附加到頁面字典
- 儲存檔案前若修改傳回的字典物件,必須使用檔案內部的修改機制,不得在檔案關閉後持有該參照