AddRelativeLinkToFileEx

注釈とホットスポットリンク

説明

別の PDF 文書内の特定ページおよび位置に相対パスでリンクするクリック可能なホットスポット矩形を、選択したページに追加します。ホットスポット境界線の色を変更するには SetAnnotBorderColor 関数を使用します

ターゲット文書へのリンクはファイル名のみを介します。これはターゲット文書のページ寸法が不明であることを意味するため、DestLeft、DestTop、DestRight および DestBottom パラメーターは常に宛先ページ's MediaBox の左下隅から測定したポイントで指定します

構文

Delphi

Function TPDFlib.AddRelativeLinkToFileEx(Left, Top, Width, Height: Double; Const FileName: WideString; DestPage: Integer; NewWindow, Options, Zoom, DestType: Integer; DestLeft, DestTop, DestRight, DestBottom: Double): Integer;

ActiveX

Function PDFlib::AddRelativeLinkToFileEx(Left As Double, Top As Double, Width As Double, Height As Double, FileName As String, DestPage As Long, NewWindow As Long, Options As Long, Zoom As Long, DestType As Long, DestLeft As Double, DestTop As Double, DestRight As Double, DestBottom As Double) As Long

DLL

int DLAddRelativeLinkToFileEx(int InstanceID, double Left, double Top, double Width, double Height, const wchar_t * FileName, int DestPage, int NewWindow, int Options, int Zoom, int DestType, double DestLeft, double DestTop, double DestRight, double DestBottom);

パラメータ

Left

ホットスポット矩形左端の水平座標

Top

ホットスポット矩形の上端の垂直座標

Width

ホットスポット矩形の幅

Height

ホットスポット矩形の高さ

FileName

リンク先 PDF 文書の完全な絶対パスとファイル名です。相対パスに変換されます

DestPage

リンク先となる出力先文書内のページ

NewWindow

0 = 現在のドキュメントを閉じてから新しいドキュメントを開く

1 = 現在の文書を新しいウィンドウで開く

Options

リンクの外観を指定します:

0 = 境界線なし

1 = 境界線を描画

出力先オブジェクトに使用するズーム率。有効値は 0～6400 です。DestType = 1 でだけ使用し、その他の DestTypes では 0 に設定します

Zoom

DestType

1 = "XYZ" - 対象ページは Left および Top パラメーターで指定した点に配置されます Zoom パラメーターはズーム率を指定します

2 = "Fit" - ページ全体をウィンドウに収まるようズームする。他のパラメーターは使用されないためゼロに設定する必要がある

3 = "FitH" - ページ幅全体が表示されるようにズームします。ページの高さはウィンドウより大きい場合も小さい場合もあります。ページは Top パラメーターで指定した垂直位置に配置されます

4 = "FitV" - ページ全体の高さが見えるようにページをズームします。ページの幅はウィンドウの幅より大きい場合も小さい場合もあります。ページは Left パラメーターで指定した水平位置に配置されます

5 = "FitR" - ページ上の特定の矩形が見えるように拡大縮小します。Left、Top、Right、および Bottom パラメーターでページ上の矩形領域を定義します

6 = "FitB" - ページ'の境界ボックスが見えるようにページを拡大縮小します

7 = "FitBH" - Top パラメーターで指定した位置にページを垂直配置します。ページ's 境界ボックスの幅全体が見えるようにページをズームします

8 = "FitBV" - ページを Left パラメータが指定する水平位置に配置します。バウンディングボックス全体の高さがウィンドウに収まるまでズームします

DestLeft

DestType = 1、4、5、8 で使用する水平位置

DestTop

DestType = 1、3、5、7 で使用される垂直位置

DestRight

矩形の右端の水平位置です。DestType = 5 で使用します

DestBottom

長方形の下部の水平位置。DestType = 5 で使用します

int NewWindow, int Options, int Zoom, int DestType, double DestLeft, double DestTop, double DestRight, double DestBottom);

Height: Double; FileName: WideString; DestPage, NewWindow, Options, Zoom, DestType: Integer; DestLeft, DestTop, DestRight,