AddAnnotationState

注释和热点链接

描述

本页在“批注和热点链接”主题下介绍 PDF Library for Delphi 中的 AddAnnotationState API 名称、参数、类名、文件名和字面量均严格保留为 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 开始的索引。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 开始的索引，如果状态或模型选择器未知、TargetAnnot 不存在或者目标注释未存储为间接对象，则返回 0

备注

状态注释在写入时设置了 Hidden 标志，因此它不会渲染在页面上；支持审查功能的 PDF 阅读器会将其显示在注释面板中。使用 GetAnnotState 和 GetAnnotStateModel 可以回读记录的状态。需要 PDF 1.5；需要时文档版本会自动提升