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