THPDFPage.AddStructureDestinationLink Method
必須のページ座標 /D フォールバック宛先と、ターゲットの StructElem を間接参照で指定する PDF 2.0 の /SD 配列を伴う GoTo アクションを持つリンク注釈を追加する。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 に格納される代替説明。PDFUACompliance 下で必須 |
戻り値
このメンバーは値を返さない
動作
/SDは PDF 2.0 のアクションエントリであるため、PDF 2.0（ISO 32000-2）を要求し、StrictVersionLockの動作に従うAddGoToLinkと同じ[page /XYZ null y null]の形で/Dを持つ GoTo アクションに加え、間接 StructElem 参照を保持する単一要素の/SD配列を出力するnilの StructElem または範囲外のFallbackPageIndexは、注釈やバージョン追加が出力される前に例外を発生させるPDFUACompliance下では、空のDescriptionが PDF/UA-1 §7.18.5 に従って例外を発生させる