ps_add_pdflink

(PECL ps >= 1.1.0)

ps_add_pdflink — 別の PDF ドキュメントのページへのリンクを追加する

説明

function 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 上の場所へのリンクを追加する

関連キーワード:

ドキュメント座標 float pdflink dest 左下右上 weblink psdoc filename ハイパーリンククリック番号矩形 note resource 最初リンク元青線注釈印刷 Acrobat Distiller Ghostview postscript