WebKCore PDFレポートライブラリEdition CookBook

1-13 付録

1-1 空文書を準備する - 1-2 ページを新規作成する - 1-3 指定したフィールドに文字列を埋め込む - 1-4 埋め込み文字列のフォントサイズを全て変更する - 1-5 フィールドに埋め込んだ文字列を右揃えにする - 1-6 複数行の文字列をフィールドの上端から表示する - 1-7 フォントサイズを変更する - 1-8 フォント名を変更する - 1-9 フォントカラーを変更する - 1-10 フィールドの背景色を設定する - 1-11 フィールドの枠線を引く - 1-12 まとめ - 1-13 付録

次ページ CookBook２へ

1-13-1 CookBookで作成したサンプルを動かすには

CookBook１（基礎編）が収められているcookbookディレクトリの構造を次に示します。

cookbook
|- chapter1-1    空文書を準備する
|- chapter1-2    ページを新規作成する
|- chapter1-3    指定したフィールドに文字列を埋め込む
|- chapter1-4    埋め込み文字列のフォントサイズを全て変更する
|- chapter1-5    フィールドに埋め込んだ文字列を右揃えにする
|- chapter1-6    複数行の文字列をフィールドの上端から表示する
|- chapter1-7    フォントサイズを変更する
|- chapter1-8    フォント名を変更する
|- chapter1-9    フォントカラーを変更する
|- chapter1-10   フィールドの背景色を設定する
|- chapter1-11   フィールドの枠線を引く
|- chapter1-12   まとめ
|- chapter1-13   付録
|- images         説明用画像
|- resources     プログラム実行に使用するファイル
|  |- form       テンプレートファイルを配置したディレクトリ
|  +- initial    テンプレートの元ファイルを配置したディレクトリ
|

サンプルプログラムは次に示すように、Chapter毎に用意したディレクトリ配下にOrderFormFin.javaファイルを配置しています。chapter1-1 には、他のChapterと異なりCookBook１（基礎編）で使用するテンプレートをコンパイルするためのTemplateCreate.javaとコードを追記していく練習用のソースコードとしてOrderFormFin_try.javaを用意しています。chapter1-2 以降のディレクトリには、サンプルプログラムOrderFormFin.java、追記したコード箇所を表示したOrderFormFin.html、サンプルプログラム実行結果orderFormFin.pdfファイルを配置しています。

cookbook
|- chapter1-1                空文書を準備する
|  |- build.xml              サンプルプログラムをコンパイル・実行
|  |                           するAntファイル
|  |- OrderFormFin.html      追記したコード箇所を表示したHTML文書
|  |- OrderFormFin.java      サンプルプログラム
|  |- orderFormFin.pdf       サンプルプログラムの実行結果
|  |- OrderFormFin_try.java  練習用ソースコード
|  +- TemplateCreate.java    使用するテンプレートをコンパイル
|                              するプログラム
|- chapter1-2                ページを新規作成する
|  |- build.xml              サンプルプログラムをコンパイル・実行
|  |                           するAntファイル
|  |- OrderFormFin.html      追記したコード箇所を表示したHTML文書
|  |- OrderFormFin.java      サンプルプログラム
|  +- orderFormFin.pdf       サンプルプログラムの実行結果
|

サンプルプログラムを簡単に実行するために、Chapter ディレクトリ毎にAnt ビルドツールのビルドファイルbuild.xmlを用意しています。

Ant ビルドツールは、1.5.xに対応しています。それ以前のバージョンをお使いやプラットフォームにAntビルドツールがインストールされていない場合には、Antビルドツールをインストールしてください。Ant ウェブページ http://ant.apache.org/から安定バージョンのAntビルドツールをダウンロードできます。 Antを動作させるために、Ant配布のbinディリクトリをあなたの PATH環境変数に、あなたのOS環境の標準的な方法で追加してください。これが完了すれば、Ant は、シェルコマンドから直接起動することができます。

サンプルを実行するには、実行したい Chapter ディレクトリに移動して、Ant コマンドを実行してください。

% ant
Buildfile: build.xml
compile:
    [depend] Deleted 0 out of date files in 0 seconds
    [javac] Compiling 1 source file to XXXXXXX/XXX/chapter1-2　 
run:
BUILD SUCCESSFUL
Total time: 2 seconds

注：サンプルを実行するには、wkc-pdflib.jarにライセンスを登録する必要があります。ライセンス登録についての詳細はこちらをご覧ください。>>インストール手順について
chapter1-2 以降のサンプルプログラムを実行する前に、chapter1-1 のAnt コマンドを実行して使用するテンプレートをコンパイルしてください。

作成したプログラムを実行するためには：
本ライブラリを使用したアプリケーションを実行するには、以下のシステムプロパティをJavaVM実行環境に設定する必要があります。

プロパティ名説明

wkc.pdf.lib.home
環境変数 WKC_PDF_HOME に設定したパスを設定してください。これは、本ライブラリが使用するホームディレクトリを指定します。通常は、WPRLインストールディレクトリをホームディレクトリとして設定してください。

1-13-2 テンプレートPDFファイルに定義されているフィールド

基礎編のテンプレートPDFファイルに定義してあるフィールドは、以下の通りです。

フィールド定義一覧
フィールド名称	フィールド意味
xFormType	フォーム利用目的
xGram.0 ～xGram.9	申込グラム数
xAmountC.0～xAmountC.9	豆合計金額
xNumber.0～xNumber.8	数量
XAmountA.0～xAmountA.8	アクセサリー合計金額
xAllAmount	総合計金額
xPayment.0～xPayment.2	お支払方法
xCard.0～xCard.2	カード種類
xCardNo.0～xCardNo.3	カード番号
xCardTermY	カード期限年
xCardTermM	カード期限月
xCardName	カードご名義
xSendDay.0～xSendDay.2	希望配達日
xSendTime.0～xSendTime.2	希望配達時間
xYear	受付年
xMonth	受付月
xDay	受付日
xCustomerName	お客様氏名
xCustomerNo	お客様番号
xPostCode	郵便番号
xAddress	ご住所
xPhoneNo	お電話番号
xFree	備考欄
xFax	FAX番号

■フィールド定義位置のイメージ：cookbook/chapter1-13/preview_OrderForm.pdf

1-13-3 TrueTypeフォントを登録する

「1-8 フォント名を変更する」以降では、TrueTypeフォント - MSGothic を使用しています。TrueTypeフォントを使用するにはフォントをWPRLに登録することが必要です。

TrueTypeフォントのWPRLへの登録は、waddTTFユーティリティを実行して行います。

「1-8 フォント名を変更する」以降のプログラムを実行する前に、WPRLホームディレクトリ下のfontsディレクトリにサンプルで使用しているMSGothicフォントを登録します。

MSGothicフォントは、Windows OS 環境に標準でmsgothic.ttcファイルとして含まれています。以後、例示は実行環境としてWindows OS 環境を想定することにします。Linux/Unix OS 環境でプログラムを実行する方は、適宜読みかえてください。

MSGothicフォントは、Windows OS 環境では以下に示すパスのどちらかにフォントファイルは存在します。

c:\windows\fonts\msgothic.ttc

c:\winnt\fonts\msgothic.ttc

このファイルをWPRLホームディレクトリ下のfontsディレクトリにコピーしてください。以降WPRLホームディレクトリを示す環境変数を%WKC_PDF_HOME%とします。

% copy msgothic.ttc %WKC_PDF_HOME%\fonts
%

■注意■: Windows OS 環境以外のLinux/Unix OS環境などでプログラムを実行する場合は、お手数ですが OS 環境に標準でバンドルされているゴシックフォントを利用するか別途購入したTrueTypeフォントを使用するように 1-8 以降のプログラムを修正してください。これらの環境で、MSGothicフォントを使用するとフォントの使用許諾違反になります。

フォントをコピー後、waddTTFユーティリティを実行してください。

% waddTTF
TrueType Font Index Creator [bulid. 2004.16]
scan fonts directory : %WKC_PDF_HOME%\fonts
append TrueType font index ...
ＭＳ ゴシック , MSGothic , msgothic.ttc,0
ＭＳ ゴシック , MS-Gothic , msgothic.ttc,0
ＭＳ Ｐゴシック , MSPGothic , msgothic.ttc,1
ＭＳ Ｐゴシック , MS-PGothic , msgothic.ttc,1
MS UI Gothic , MSUIGothic , msgothic.ttc,2
MS UI Gothic , MS-UI-Gothic , msgothic.ttc,2
... finished.

fontsディレクトリのtrue_type_fonts.propertiesプロパティファイルの内容が以下のようになることを確認してください。

MS-Gothic=msgothic.ttc,0
MSGothic=msgothic.ttc,0
MS-PGothic=msgothic.ttc,1
MSPGothic=msgothic.ttc,1
MS-UIGothic=msgothic.ttc,2
MSUIGothic=msgothic.ttc,2

これで設定は終了です。
なおより詳細な説明については、こちらをご覧ください。>>「ツールコマンドの使い方-4 TrueTypeフォント登録ユーティリティ(waddTTF)

次ページ CookBook２へ

WebKCore^(TM) PDFレポートライブラリEdition		KITシステムズ株式会社
		JFEシステムズ株式会社