ps_add_locallink

(PECL ps >= 1.1.0)

ps_add_locallink — 同一ドキュメント内のページへのリンクを追加する

説明

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

関連キーワード:

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