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 | /D 明確目標在非 PDF 2.0 檢視器上使用的必要頁面索引 |
YPos | /XYZ 配適的選擇性垂直位置；傳入負值表示留空為 null |
Description | 存入註解 /Contents 的替代描述；在 PDFUACompliance 下為必要 |
傳回值
此成員不傳回值
行為
- 需要 PDF 2.0（ISO 32000-2），並遵循
StrictVersionLock行為，因為/SD是 PDF 2.0 的 action 條目 - 發出 GoTo 動作，
/D採用與AddGoToLink相同的[page /XYZ null y null]形狀，另附持有間接 StructElem 參照的單元素/SD陣列 nil的 StructElem 或超出範圍的FallbackPageIndex會在任何註解或版本升級發出之前就引發例外- 在
PDFUACompliance下，空的Description會依 PDF/UA-1 §7.18.5 引發例外