AddLinkToEmbeddedPDFA
注釈とホットスポットリンク
説明
末尾の A は ANSI(char)DLL エントリポイントを示し、ActiveX/COM の表面では Unicode 形式のみ公開される。動作は AddLinkToEmbeddedPDF と同一で、文字列引数は現在の SetAnsiMode コードページを使って解釈される
現在のファイルに埋め込まれた PDF ドキュメントを開き、そのページへ移動するホットスポットリンクを選択ページに追加します。ISO 32000-1 §12.6.4.4 の埋め込み go-to(/GoToE)アクションを保持し、対象チェーンはドキュメント'の EmbeddedFiles 名前ツリー内の埋め込みファイル(EmbedFile に渡した名前)を指し、移動先は対象ページをウィンドウに合わせます
/GoToE は PDF 1.6 で導入されたため、この関数を呼び出すと必要に応じてドキュメントバージョンが 1.6 に引き上げられます。このようなアクションを読み戻すには GetAnnotActionInfo を使用します。埋め込みターゲット名、親子関係、/NewWindow フラグとともに種別 akGoToE が報告されます
構文
Delphi
Function DLAddLinkToEmbeddedPDFA(InstanceID: Integer; Left, Top, Width, Height: Double; EmbeddedFileName: PAnsiChar; TargetPage, NewWindow, Options: Integer): Integer;
DLL
int DLAddLinkToEmbeddedPDFA(int InstanceID, double Left, double Top, double Width, double Height, const char * EmbeddedFileName, int TargetPage, int NewWindow, int Options);
パラメータ
| Left, Top, Width, Height | 選択したページ上のホットスポット領域の位置とサイズ |
|---|---|
| EmbeddedFileName | EmbedFile に渡される、文書's EmbeddedFiles 名前ツリー内の埋め込みファイル名 (例: "report.pdf") |
| TargetPage | 埋め込みドキュメント内で移動先となる 1 から始まるページ番号 |
| NewWindow | 1 = ビューアーに埋め込み文書を新しいウィンドウで開くよう要求する、0 = ビューアー既定値 |
| Options | 1 = ホットスポットの周囲に境界線を描画、0 = 境界線なし |
戻り値
| 0 | リンクを追加できませんでした 名前が空かページが無効です |
|---|---|
| 1 | Success |