THPDFPage.AddGoToRStructureDestinationLink Method

添加一个链接批注，其 GoToR 动作按目标元素的字节串 /ID 指向外部 PDF 中的某个结构元素，同时在远程文件中保留必需的 /D 回退页面目标

声明

procedure AddGoToRStructureDestinationLink(Rectangle: TRect; const FileName: AnsiString;
  const RemoteStructElemID: AnsiString; FallbackTargetPageIndex: Integer= 0;
  YPos: Single= - 1; NewWindow: boolean= false; const Description: AnsiString= '');

单元

HPDFDoc

参数

名称	用途
`Rectangle`	以页面单位表示的链接活动热区矩形
`FileName`	外部 PDF 的非空路径；反斜杠会规范化为正斜杠
`RemoteStructElemID`	目标 StructElem 的非空字节串 `/ID`，位于 `FileName` 中；必须与该元素上的 `/ID` 一致，即用 `IDStr` 重载的 `AddStructureElement` 写入的那个
`FallbackTargetPageIndex`	远程文件中 `/D` 回退目标所用的、必需的从零开始的页索引；必须 `>= 0`
`YPos`	`/XYZ` 适配的可选垂直位置；传入负值则保持为 null
`NewWindow`	为 true 时，输出 `/NewWindow true`，让阅读器在新窗口中打开目标
`Description`	存储在注释中的备用说明 `/Contents`; required under `PDFUACompliance`

返回值

此成员不返回值

行为

Requires PDF 2.0 (ISO 32000-2) and follows StrictVersionLock behavior
远程结构目标无法通过指针引用外部文档的 StructElem，因此 ISO 32000-2 §12.3.2.3 要求第一个 /SD 元素是目标元素的字节串 /ID；输出的字面字符串形式与 /ID 形式一致，即 AddStructureElement 针对同一 IDStr 生成的形式
输出一个 GoToR 动作，包含 /F、必需的 /D 回退目标和 /SD 字节串数组
空的 FileName, empty RemoteStructElemID, or negative FallbackTargetPageIndex 在发出任何注释或版本提升之前引发

THPDFPage.AddGoToRStructureDestinationLink Method

声明

单元

参数

返回值

行为

相关 API