THPDFFDFAnnotationGraph 类

单元：HPDFFDFAnnotations

拥有一个有界 FDF 值图、其间接对象及其注释数组

读取与写入

Decode(Bytes, Options, AllowFields) 校验完整的二进制 FDF 数据并返回调用方拥有的图；Encode 返回规范 FDF 字节，其中流长度和交叉引用偏移重新生成

AnnotationCount、Annotation、AnnotationPage 和 ObjectCount 检查已准入的注释图；Resolve 沿图作用域的间接引用追踪

可选的 AllowFields 解码标志允许 Fields 数组用于图检查；它不实现字段填充，也不授权仅注释适配器丢弃字段更新

构建

用 THPDFFDFOptions 创建图，调用 StartAnnotations，再用 CreateValue、SetScalar、SetStream、AddItem、AddEntry、Define 和 AppendAnnotation 构造其值

构建器的标量 token 使用 PDF 语法，例如带斜杠前缀的名称或括号字符串；字典条目名称是解码后的名称字节，不带前导斜杠

每个值都属于其图，容器条目是借用的；不要单独释放子值、不要附加来自其他图的值，也不要在释放图之后继续持有值

构建的流在编码期间获得其规范 Length；请提供流字节，而不是手工构造匹配的 Length 条目

上下文与限制

ActionCount、Action、IsLocalGoTo、IsLocalDestination 和 LocalDestinationPage 检查实际注释 action 上下文，不执行其中的 action

图变更使缓存的 action 上下文失效；后续查询在相同的工作存储、深度和取消限制下重建它们

ReservedBytes 报告保守的准入核算，Reserve 允许适配器在分配之前准入额外的图相关存储

畸形引用、重复的解码字典名称、无效注释页面、不可准入的子类型和超限都会在返回编码结果之前抛出异常

文档级替换、权限和发布行为见原生注释 FDF 交换