AddLinkToNamedAction
注釈とホットスポットリンク、ページプロパティ
説明
選択ページにクリック可能なホットスポット矩形を追加し、アクティブ化時に PDF 名前付きアクションを起動する。名前付きアクションは ISO 32000-1 §12.6.4.11, Table 194 で定義された、ビューアーが制御するナビゲーションコマンド。対応する4つの標準名は NextPage、PrevPage、FirstPage、LastPage。AddLinkToPage と異なり、明示的な移動先ページ番号は不要であり — ビューアーが実行時にコマンドを解釈する
典型的な使用例: ページヘッダーまたはフッター上のナビゲーションボタン（次へ / 前へ / ホーム / 終了）。宛先はビューアーが現在表示しているページを基準にします
ホットスポット境界線の色を変更するには SetAnnotBorderColor 関数を使用する
構文
Delphi
Function TPDFlib.AddLinkToNamedAction(Left, Top, Width, Height: Double; NamedActionType: Integer; Options: Integer): Integer;DLL
int DLAddLinkToNamedAction(int InstanceID, double Left, double Top, double Width, double Height, int NamedActionType, int Options);パラメータ
| Left | ホットスポット矩形の左端の水平座標 |
|---|---|
| Top | ホットスポット矩形の上端の垂直座標 |
| Width | ホットスポット矩形の幅 |
| Height | ホットスポット矩形の高さ |
| NamedActionType | トリガーする名前付きアクションを選択します: 0 = NextPage、1 = PrevPage、2 = FirstPage、3 = LastPage。範囲外の値は NextPage にフォールバックするため、ライターは常に仕様準拠の /N 名を出力します |
| Options | リンクの外観を制御するビットマスク。ビット 0（値 1）: ホットスポット矩形の周囲に境界線を描画。ビット 1–3 でクリック時の強調表示モードを選択（2 = Invert、4 = Outline、8 = Push）。強調表示ビットが設定されていない場合、既定値として Invert が使用されます。AddLinkToWeb / AddLinkToPage と同じ規約です |
備考
外部リソースを参照しないため、この注釈は PDF/A 互換である。PDF 1.1 以降が必要