ps_add_bookmark
(PECL ps >= 1.1.0)
ps_add_bookmark — 現在のページにブックマークを追加する
説明
ps_add_bookmark
( resource $psdoc
, string $text
[, int $parent
= 0
[, int $open
= 0
]] ) : int
現在のページにブックマークを追加します。たいてい、ブックマークは PDFビューア上でページの左側にツリー形式で表示されます。 ブックマークをクリックすると、該当ページにジャンプします。
注釈は、 ドキュメントを印刷したり表示したりするときには表示されません。 しかし、Acrobat Distiller? あるいは Ghostview でドキュメントを pdf に変換すると表示されます。
パラメータ
psdoc
- ps_new() が返す、postscript ファイルのリソース ID。
text
- ブックマークの表示に使用するテキスト。
parent
- 新しいブックマークの親となる、 事前にこの関数で作成されたブックマーク。
open
open
がゼロでない場合、ブックマークは PDF ビューア上で開いた形で表示されます。
返り値
返り値はブックマークへの参照です。この値は、作成したブックマークを 他のブックマークの親として使用する場合にのみ使われます。 成功した場合には、この値はゼロより大きくなります。 エラーが発生した場合にはゼロを返します。
参考
- ps_add_launchlink() - ファイルを実行するためのリンクを追加する
- ps_add_pdflink() - 別の PDF ドキュメントのページへのリンクを追加する
- ps_add_weblink() - Web 上の場所へのリンクを追加する