AddLinkToNamedDestinationA
注釈とホットスポットリンク、ページプロパティ
説明
末尾の A は ANSI（char）DLL エントリポイントを示します。ActiveX/COM インターフェースでは Unicode 形式のみを公開します。動作は AddLinkToNamedDestination と同じで、文字列引数は現在の SetAnsiMode コードページを使用して解釈されます
選択したページにクリック可能なホットスポット矩形を追加し、同じ PDF 文書内の名前付き出力先へ移動します。まず NewDestination と NewNamedDestination で対象を登録し、ページ番号と出力先配列を重複させず、安定した出力先名を参照するホットスポットを作成します
ホットスポット境界線の色を変更するには SetAnnotBorderColor 関数を使用する
構文
Delphi
Function DLAddLinkToNamedDestinationA(InstanceID: Integer; Left, Top, Width, Height: Double; DestName: PAnsiChar; Options: Integer): Integer;DLL
int DLAddLinkToNamedDestinationA(int InstanceID, double Left, double Top, double Width, double Height, const char * DestName, int Options);パラメータ
| Left | ホットスポット矩形の左端の水平座標 |
|---|---|
| Top | ホットスポット矩形の上端の垂直座標 |
| Width | ホットスポット矩形の幅 |
| Height | ホットスポット矩形の高さ |
| DestName | ジャンプ先の名前付き宛先。名前は通常 NewNamedDestination により、すでに文書の名前ツリーに存在している必要があります |
| Options | リンクの外観を制御するビットマスク ビット 0（値 1）はホットスポット矩形の周囲に枠線を描画する ビット 1–3 はクリック時のハイライトモードを選択する（2 = 反転、4 = アウトライン、8 = 押下） ハイライトビットが設定されていない場合は、既定で反転が使用される |
戻り値
| 0 | DestName が空であるか、リンクを作成できなかった |
|---|---|
| 1 | 名前付き移動先リンクが選択したページに追加されました |
備考
リンク注釈は、移動先が名前付き移動先文字列である GoTo アクションを書き込みます。これにより、名前付き移動先の作成後にページが挿入または移動されてもホットスポットが安定します