GetXRefDiagnostics
文档管理、诊断、恢复
描述
返回加载选定文档所使用的交叉引用与恢复路径的 JSON 报告
语法
Delphi
Function TPDFlib.GetXRefDiagnostics: WideString;返回值
| 空字符串 | 未选定已加载文档，且 LastErrorCode 被设为 401 |
|---|---|
| JSON 报告 | 报告已返回 |
报告字段
| 文件位置 | fileSize、headerOffset、startXRefTokenOffset、declaredStartXRef、effectiveStartXRef、eofOffset 和 trailingBytes |
|---|---|
| 交叉引用摘要 | policy 为 strict、compatible 或 recovery；xrefType 为 table、stream、hybrid、mixed 或 unknown；hasXRefStream、hybrid、shiftedHeader、sectionCount 和 trailerCount 描述选定的链 |
| 条目计数 | entries 报告已分配槽位以及空闲、使用中、压缩和无效条目 |
| 决策 | decisions 按求值顺序报告选定的链类型、跟踪的链接、兼容性修复和被拒绝的节 |
| 节 | 每一项报告声明的与物理的偏移、表或流类型、startxref、prev 或 xrefstm 来源、闭区间的 trailer 字典边界、链接偏移、解析尝试、compatibilityFlags 和成功状态 |
| 恢复 | recovery 报告 strict、repair 或 best-effort 模式、是否尝试并成功回退、恢复的对象数量、trailer 来源和有序决策 |
说明
所有字节位置从 0 开始；不可用的位置报告为 -1头部偏移的重试仍以尝试 2 的形式可见，因此可以比较声明位置与有效位置，而不会隐藏失败的首次尝试恢复决策可以包括
raw-object-scan、recover-object-stream-members 和 synthesize-trailer