CookBook1 基礎編

1-11フィールドの枠線を引く

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ファイル：cookbook1/chapter1-11/OrderFormFin.java

コードの追記が終了したら、プログラムを実行し生成されたPDF帳票を開いてみましょう。
指定したフィールドに背景色がついていることを確認してください。
◎出力されたPDF帳票：cookbook1/chapter1-11/OrderFormFin.pdf

テキストフィールドのプロパティを変更してみよう

"テキストフィールドのプロパティ"ダイアログでは、"表示方法"タブの"境界線の色"項目で、フィールドの枠線の色を決定できます。
デフォルトの設定では[無色]です。
"境界線の色"を変更すると、上記で説明したAPI[setBorderColor（PdfColor color）]と同様の制御ができます。
また、API[setBorderStyle(int borderStyle)]は "スタイル"、API[setLineWidth(float lineWidth)]は "幅"で同様に制御できます。
※プロパティの"幅"の [細い]＝1.0f/[標準]＝2.0f/[太い]＝3.0fと一致します。
全プロパティの設定については、「テンプレートの作り方」を参考にしてください。

PAGE TOP