3.1.2 しおりの追加
狙い・効果
PDF文書にしおりを作成します。
処理の概要
サンプルPDF文書（bookmark-0.pdf）にはしおりがありません。そこで次のようなしおりを付けます。
図3･1 しおりをつけようとするPDF
- しおりの階層構造は次の2階層とします。
- 最上位階層は1ページ目の見出し「PDFにしおりを付ける」
- その子供として2ページ目の見出し「Bookmark sample-1」と、外部URL（http://www.antenna.co.jp/）へのリンク
- しおりのタイトルは各見出しの文字列とURLとします。
- 各しおりのタイトルには色を設定しています。
- 「PDFにしおりを付ける」はPtlDestFitを用い、ページの全体が水平方向と垂直方向の両方ともウィンドウ内にちょうど収まる倍率で表示します。また、アウトラインフラグを指定することでしおり表記を太字指定にしています。
- 「Bookmark sample-1」はPtlDestFitHで高さ指定を行い、ページの本文をウィンドウの上端に配置し、ページの幅全体がウィンドウ内にちょうど収まる倍率で表示します。（このため、幅が狭い状態で表示させると上端の調整は行われません）。
- 「http://www.antenna.co.jp/」はリンク動作をします。また、アウトラインフラグを論理和を用いて指定することで、しおり表記の太字・イタリックを同時指定しています。
『PDF Tool API』の主な機能
- PtlOutline.APIsetTitle() :アウトラインタイトル文字列を設定
- PtlOutline.APIsetColor() :アウトラインタイトルの色を設定
- PtlOutline.APIsetFlags() :アウトラインフラグを設定
- PtlOutline.APIsetOpen() :PDF表示時の子アウトラインをオープンするかどうかの設定
- PtlOutline.APIappendLastChild() :子アウトラインの追加
- PtlOutline.APIappendNextSibling() :兄弟アウトラインの追加
- PtlOutline.APIsetAction() :アクションの設定
- PtlActionURI.APIsetURI() :URIを設定 PtlActionGoTo, PtlActionGoToRに共通のメソッド
- APIsetDest() :宛先の設定
- PtlDest.APIsetPageNumber() :宛先ページの設定
- PtlDest.APIsetTop() :座標の設定上
プログラム例
package cookbook;
import jp.co.antenna.ptl.*;
public class AppendOutline {
/**
* @param args the command line arguments
*/
public static void main(String[] args) {
if (args.length < 2) {
System.out.println("usage: java AppendOutline in-pdf-file out-pdf-file");
return;
}
...【WaterMarkSetMargin.javaと同じ処理のため省略
・PtlParamInputを用いてPtlPDFDocument docに入力PDFをロード
・PtlParamOutputを用いて出力PDF名を指定】...
try (PtlOutline outlineRoot = doc.getRootOutline()) { //ルートアウトラインの取得
// しおりの追加
createOutline(outlineRoot);
}
...【EncryptWithUserPass.javaと同じ処理のため省略
・PtlParamOutputを用いてPtlPDFDocument docの内容を出力
・PtlException, Exception, Error を catchするエラー処理
・finally文で"--完了--"と表示する処理】...
}
static void createOutline(PtlOutline outlineRoot)
throws PtlException, Exception, Error {
try (PtlOutline outlineActionGoToTop = new PtlOutline()) {
outlineActionGoToTop.setTitle("PDFにしおりを付ける");
// アクション
// PtlActionGoTo : GoToアクション<現在のドキュメント内の宛先へ移動>
try (PtlActionGoTo actionGoTo = new PtlActionGoTo();
PtlDestFit destFit = new PtlDestFit()) { // PtlDestFit : Fit型
// 宛先ページの設定(ページ番号は0ベース)
destFit.setPageNumber(0);
// 宛先の設定
actionGoTo.setDest(destFit);
// アクションの設定
outlineActionGoToTop.setAction(actionGoTo);
}
// アウトラインタイトルの色を設定
try (PtlColorDeviceRGB color = new PtlColorDeviceRGB(1.0f, 0.0f, 0.0f)) {
outlineActionGoToTop.setColor(color);
}
// アウトラインフラグを設定 (FLAG_BOLD : 太字)
outlineActionGoToTop.setFlags(PtlOutline.FLAG_BOLD);
// PDF表示時の子アウトラインをオープンするかどうかの設定
outlineActionGoToTop.setOpen(true);
// 子アウトラインの追加
outlineRoot.appendLastChild(outlineActionGoToTop);
try (PtlOutline outlineActionGoTo2 = new PtlOutline()) {
outlineActionGoTo2.setTitle("Bookmark sample-1");
// アクション
// PtlActionGoTo : GoToアクション<現在のドキュメント内の宛先へ移動>
try (PtlActionGoTo actionGoTo2 = new PtlActionGoTo();
PtlDestFitH destFitH = new PtlDestFitH()) { // PtlDestFitH : FitH型
// 宛先ページの設定(ページ番号は0ベース)
destFitH.setPageNumber(1);
// topの設定(本文の文章がちょうど一番上に来るように調整)
destFitH.setTop(245);
// 宛先の設定
actionGoTo2.setDest(destFitH);
// アクションの設定
outlineActionGoTo2.setAction(actionGoTo2);
}
// アウトラインタイトルの色を設定
try (PtlColorDeviceRGB color = new PtlColorDeviceRGB(0.0f, 0.5f, 0.0f)) {
outlineActionGoTo2.setColor(color);
}
// アウトラインフラグを設定（FLAG_NORMAL : ノーマル）
outlineActionGoTo2.setFlags(PtlOutline.FLAG_NORMAL);
// PDF表示時の子アウトラインをオープンするかどうかの設定
outlineActionGoTo2.setOpen(false);
// 子アウトラインの追加
outlineActionGoToTop.appendLastChild(outlineActionGoTo2);
// URIアクション -----------------------------------
try (PtlOutline outlineActionURI = new PtlOutline()) {
// アウトラインタイトル文字列を設定
outlineActionURI.setTitle("http://www.antenna.co.jp/");
// アクション
// PtlActionURI : URIアクション
try (PtlActionURI actionuri = new PtlActionURI()) {
// URIを設定
actionuri.setURI("http://www.antenna.co.jp/");
// アクションの設定
outlineActionURI.setAction(actionuri);
}
// アウトラインタイトルの色を設定
try (PtlColorDeviceRGB color = new PtlColorDeviceRGB(0.0f, 0.0f, 1.0f)) {
outlineActionURI.setColor(color);
}
// アウトラインフラグを設定
// (FLAG_BOLD : 太字 と、 FLAG_ITALIC : イタリック の論理和)
outlineActionURI.setFlags(PtlOutline.FLAG_BOLD | PtlOutline.FLAG_ITALIC);
// PDF表示時の子アウトラインをオープンするかどうかの設定
// （false : 新ウィンドウでオープンしない）
outlineActionURI.setOpen(false);
// Bookmark sample-1の兄弟アウトラインとして追加
outlineActionGoTo2.appendNextSibling(outlineActionURI);
}
}
}
}
}
プログラムファイル名
AppendOutline.java
入出力操作の例
次図は出力PDFを開いてしおりを表示し、「Bookmark sample-1」をクリックしたときの画面です。
図3･2 出力PDFのしおり