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 為基底）；必須 `>= 0`
`YPos`	`/XYZ` 配適的選擇性垂直位置；傳入負值表示留空為 null
`NewWindow`	為 true 時發出 `/NewWindow true`，讓檢視器在新視窗開啟目標
`Description`	存入註解 `/Contents` 的替代描述；在 `PDFUACompliance` 下為必要

傳回值

此成員不傳回值

行為

需要 PDF 2.0（ISO 32000-2），並遵循 StrictVersionLock 的行為
遠端結構目標無法用指標參照外部的 StructElem，因此 ISO 32000-2 §12.3.2.3 要求第一個 /SD 元素必須是目標元素的位元組字串 /ID；發出的字面字串形式與 AddStructureElement 為同一 IDStr 產生的 /ID 形式一致
發出帶有 /F、必要 /D 後援目標與 /SD 位元組字串陣列的 GoToR 動作
空的 FileName、空的 RemoteStructElemID 或負數的 FallbackTargetPageIndex 會在任何註解或版本升級發出之前就引發例外

THPDFPage.AddGoToRStructureDestinationLink Method

宣告

單元

參數

傳回值

行為

相關 API