HPDFXFDFImportAnnotations 函数

function HPDFXFDFImportAnnotations(const Access: THPDFXFDFAccess;
  const Destinations: THPDFXFDFDestinationAccess;
  Root: THPDFXFDFNode): Integer; overload;

通过提供的访问回调映射注释 XML,返回创建的注释数量

独立的目标回调把本地页数组绑定到真实的文档间接页,并保留具名 Unicode 目标和精确设界的十进制坐标

原始 overload 保留其签名并使用空目标记录;显式页目标需要 page-count 和 page-object 回调

这个低层回调映射器自身不提供整篇文档回滚;需要设界准入、经认证的策略和原子文件发布时,请使用 SaveAnnotationsXFDFToFile

目标属性与限制

标准 stamp 外观传输通过 base64 类型化 XML 保留真实的 Form 流以及有界的无环字体、图像和图形资源

function HPDFXFDFImportAnnotations(const Access: THPDFXFDFAccess;
  const Destinations: THPDFXFDFDestinationAccess; Root: THPDFXFDFNode;
  MaxAppearanceBytes, MaxAppearanceNodes, MaxAppearanceDepth: Integer;
  MaxAppearanceWorkingBytes: Int64;
  CancellationToken: THPDFCancellationToken): Integer; overload;

各限制为正且累计生效,外观深度上限 62;旧 overload 提供 16 MiB、100000 个节点、深度 62 和 512 MiB 工作预留

创建的间接流仍归提供的图适配器所有;低层编解码器不接管调用方文档的所有权,也不提供整操作回滚

适配器在 ANSI 转换和解码存储之前,按含空白的原始 base64 长度预留;RAW HEX 和 ASCII 数据在分配流字节数组之前预留

工作预留对完整导入保守且累计,与输出字节无关;调用方自有解析出的 XFDF 树由调用方在这个适配器消费之前先行准入

词法预检会在构建树之前预留解码后的 XML 节点与属性记录以及继承的命名空间作用域数组;节点数、深度和工作存储是相互独立的累计限额

AP 专项预检在调用共享 XML 读取器之前校验既有的对象标签词汇,保持对非法类型的拒绝,同时不留存无关的 XHTML RawXML 片段