FAX番号のフィールドを枠線付きで表示してみましょう。
フィールドに枠線を引くAPIは、サンプルのように罫線の表示を切り替えたいときや、
(例では、お客様がFAXをお持ちのときだけ表示する項目)
また、帳票の中で文字を目立たせたい場合に利用すると効果的です。
利用するAPIは以下の通りです。
- <利用API-1>
- クラス:
Field
- メソッド:
setBorderColor(PdfColor color)
- <引数>
color:フィールドの枠線の色。
- <用途>
- フィールドの枠線の色を変更します。
- ※設定できる色は「1-8 フォントカラーを変更する」と同様です。(デフォルトは無色(NULL)です。)
- <利用API-2>
- クラス:
Field
- メソッド:
setBorderStyle(int borderStyle)
- <引数>
borderStyle:枠線のスタイル
- <定数>
Field.BORDER_STYLE_SOLID //「実線」
Field.BORDER_STYLE_DASHED //「破線」
Field.BORDER_STYLE_BEVELED //「ベベル」
Field.BORDER_STYLE_INSET //「インセット」
Field.BORDER_STYLE_UNDERLINE//「下線」
- <用途>
- 表示したい枠線のスタイルを選択します。枠線全てを線引きしたい(囲む)場合は
BORDER_STYLE_SOLID、下線を引きたい場合は BORDER_STYLE_UNDERLINEをセットしてください。
- ※2004年度版では、ベベル、インセットを指定した場合は無効となります。
- <利用API-3>
- クラス:Field
- メソッド:setLineWidth(float lineWidth)
- <引数>
- lineWidth:枠線の幅
- <用途>
- 枠線の太さを選択します。
- lineWidthの範囲は
- ±3.40282347E+38 ≦ lineWidth ≦ ±1.40239846E-45
です。
<記述例>
Field Field = report.getField("xFax");
Field.setBorderStyle(Field.BORDER_STYLE_SOLID);
Field.setBorderColor(PdfGrayColor.BLACK);
report.putFieldData(field,"FAX番号:03-4444-5555");
記述例を参考にして、フィールドの枠線を引くコードを追記してください。
追記されたコードは
こちらをご覧ください。
◎javaファイル:cookbook/chapter1-11/OrderFormFin.java
コードの追記が終了したら、プログラムを実行し生成されたPDF帳票を開いてみましょう。
指定したフィールドの枠線が引けていることを確認してください。
◎出力されたPDF帳票:cookbook/chapter1-11/orderFormFin.pdf
☆コラム☆〜 テキストフィールドのプロパティを変更してみよう 〜
"テキストフィールドのプロパティ"ダイアログでは、"表示方法"タブの"境界線の色"項目で、フィールドの枠線の色を決定できます。デフォルトの設定では[無色]です。"境界線の色"を変更すると、上記で説明したAPI[setBorderColor(PdfColor color)]と同様の制御ができます。また、API[setBorderStyle(int borderStyle)]は "スタイル"、API[setLineWidth(float lineWidth)]は "幅"で同様に制御できます。※プロパティの"幅"の [細い]=1.0f/[標準]=2.0f/[太い]=3.0fと一致します。全プロパティの設定については、「テンプレートの作り方」を参考にしてください。
|