THPDFPage.AddStructureDestinationLink Method

添加一个链接批注，其 GoTo 动作携带必需的页面坐标 /D 回退目标，以及以间接引用命名目标 StructElem 的 PDF 2.0 /SD 数组，这样 PDF 2.0 阅读器会跳转到结构内容，而旧版阅读器则回退到指定页面

声明

procedure AddStructureDestinationLink(Rectangle: TRect; StructElem: THPDFDictionaryObject;
  FallbackPageIndex: Integer; YPos: Single= - 1; const Description: AnsiString= '');

单元

HPDFDoc

参数

名称	用途
`Rectangle`	以页面单位表示的链接活动热区矩形
`StructElem`	要指向的非 nil 间接 StructElem 字典，通常来自 `AddStructureElement` 或 `FindStructureElementForMCID`
`FallbackPageIndex`	非 PDF 2.0 阅读器使用的、`/D` 显式目标所需的页索引
`YPos`	`/XYZ` 适配的可选垂直位置；传入负值则保持为 null
`Description`	存储在注释中的备用说明 `/Contents`; required under `PDFUACompliance`

返回值

此成员不返回值

行为

需要 PDF 2.0（ISO 32000-2），并遵循 StrictVersionLock 行为，因为 /SD 是 PDF 2.0 的动作条目
输出一个 GoTo 动作，其 /D 采用 [page /XYZ null y null] 的形式（与 AddGoToLink 相同），另附一个单元素的 /SD 数组，其中存放间接 StructElem 引用
A nil StructElem or an out-of-range FallbackPageIndex 在发出任何注释或版本提升之前引发
Under PDFUACompliance an empty Description raises per PDF/UA-1 §7.18.5

THPDFPage.AddStructureDestinationLink Method

声明

单元

参数

返回值

行为

相关 API