AddAnnotationState

註解與熱點連結

描述

此頁面描述 PDF Library for Delphi 在「註解與熱點連結」主題下的 AddAnnotationState。API 名稱、參數、類別名稱、檔案名稱與字面量（literals）皆完全保留其在 Delphi 程式庫與 DLL 進入點中的原始樣貌。

AddAnnotationState 可為所選頁面上現有的註解記錄審閱狀態變更（ISO 32000-1 §12.5.6.3）。它會附加一個隱藏的 Text 註解，其 /IRT 項目參照目標註解，且 /State 與 /StateModel 項目攜帶審閱狀態，與 Acrobat 評論面板使用的審閱工作流程相符。

語法

Delphi

Function TPDFlib.AddAnnotationState(TargetAnnot: Integer; Const Author: WideString; State, StateModel: Integer): Integer;

參數

TargetAnnot 是所選頁面上要設定狀態之註解的 1-based 索引。Author 是儲存於 /T 項目的審閱者名稱。StateModel 選取狀態模型：0 = Review，1 = Marked。State 選取模型內的狀態。對於 Review 模型：0 = None，1 = Accepted，2 = Rejected，3 = Cancelled，4 = Completed。對於 Marked 模型：0 = Unmarked，1 = Marked。

傳回值

傳回頁面註解清單中新附加之狀態註解的 1-based 索引；若狀態或模型選擇器未知、TargetAnnot 不存在，或是目標註解未儲存為間接物件時，則傳回 0。

備註

狀態註解在寫入時會設定 Hidden 旗標，因此不會渲染在頁面上；支援審閱功能的 PDF 檢視器會改在評論面板中顯示它。請使用 GetAnnotState 與 GetAnnotStateModel 來讀回記錄的狀態。需要 PDF 1.5；需要時文件版本會自動提升。