ps_add_pdflink
(PECL ps >= 1.1.0)
ps_add_pdflink — 別の PDF ドキュメントのページへのリンクを追加する
説明
ps_add_pdflink
( resource $psdoc
, float $llx
, float $lly
, float $urx
, float $ury
, string $filename
, int $page
, string $dest
) : bool
指定した位置に、別の PDF ドキュメントへのハイパーリンクを設定します。 リンクをクリックすると、そのドキュメントの指定されたページに移動します。 ドキュメントの最初のページのページ番号は 1 です。
ハイパーリンクのリンク元は矩形で表され、その左下の座標は
(llx
, lly
)、
そして右上の座標が (urx
, ury
)
となります。この矩形はデフォルトでは細い青線で表されます。
注釈は、 ドキュメントを印刷したり表示したりするときには表示されません。 しかし、Acrobat Distiller? あるいは Ghostview でドキュメントを pdf に変換すると表示されます。
パラメータ
psdoc
- ps_new() が返す、postscript ファイルのリソース ID。
llx
- 左下角の x 座標。
lly
- 左下角の y 座標。
urx
- 右上角の x 座標。
ury
- 右上角の y 座標。
filename
- リンクがクリックされた際に開かれる PDF ドキュメントの名前。
page
- 対象 PDF ドキュメントのページ番号。
dest
dest
は、ドキュメントがどのように 表示されるかを指定します。とりうる値はfitpage
またはfitwidth
、fitheight
、fitbbox
のいずれかです。
返り値
成功した場合に true
を、失敗した場合に false
を返します。
参考
- ps_add_launchlink() - ファイルを実行するためのリンクを追加する
- ps_add_locallink() - 同一ドキュメント内のページへのリンクを追加する
- ps_add_weblink() - Web 上の場所へのリンクを追加する