jvCreate(初期処理-JNI)
レポートライブラリJNIの初期処理を行います。
[構文]
X86対応版
Int jvCreate(int outdev, int hwnd, int prnhdc, int winhdc, int width, int height, String filename);
X64対応版
Int jvCreate(int outdev, long hwnd, long prnhdc, long winhdc, int width, int height, String filename);
設定項目 |
内容 |
outdev
|
出力先デバイス(設定値参照) |
hwnd |
0を設定 |
prnhdc |
プリンタデバイスコンテキスト |
winhdc |
0を設定 |
width |
帳票の幅(1/100mm単位) |
height |
帳票の高さ(1/100mm単位) |
filename |
出力ファイル名 |
リターンコード
定数 |
値 |
内容 |
JV_ERR_JVCREATE以外 |
|
正常終了 |
JV_ERR_JVCREATE |
-1 |
オープンエラー |
[設定値]
outdev には次の値を設定します。
定数 |
値 |
内容 |
JV_PRINTER |
2 |
プリンタへ出力 |
JV_BITMAPFILE |
3 |
ビットマップファイルへ出力 |
JV_RDF |
5 |
RDF形式でメモリへ出力 |
JV_RDFSVC |
7 |
RDFサービスデータを共有メモリへ出力 |
JV_PDF |
9 |
Adobe PDF形式でメモリへ出力 |
[解説]
jvCreateのリターン値は、ジョブIDとして他のファンクションのパラメータとなります。
jvCreateをコールした場合は、最後に必ずjvCloseをコールしてください。jvCreateとjvCloseは対になるようにコーディングします。
エラーが発生した時は、jvGetOpenErrorを使って詳しいエラー内容を取得することができます。
出力先デバイス
outdev には帳票を出力するデバイスを設定します。「JV_PRINTER」は、帳票を直接プリンタへ出力する時に指定します。「JV_BITMAPFILE」は、帳票をBMP形式のイメージファイルに保存する時に指定します。「JV_RDF」は、帳票をRDF形式で出力しプレビューコントロールでプレビューや印刷する時に指定します。「JV_RDFSVC」は、帳票をRDFサービスで使う時に指定します。「JV_PDF」は、帳票をAdobe PDF形式で出力する時に指定します。
出力されたRDF形式やAdobe PDF形式のデータをファイルに保存する場合は filename
パラメータを使います。メモリ上で取得する場合にはjvGetDocument と jvGetLong
を使います。RDFサービスで使う場合には、jvCloseを使ってRDFサービスデータIDを取得します。
ウィンドウハンドル/ウィンドウデバイスコンテキスト
hwnd
とwinhdc は、常に0を指定します。
プリンタデバイスコンテキスト
prnhdc
には印刷するプリンタのデバイスコンテキスト(Printer.hDC)を設定します。プリンタデバイスコンテキストが取得できない言語環境では 0
を設定することができます。0 を設定すると、レポートライブラリがprnhdc にデフォルトプリンタ(通常使うプリンタに指定されたプリンタ)のデバイスコンテキストを設定します。
レポートライブラリは、実行時に、プリンタドライバから様々な情報を取得し帳票を作成します。prnhdc
で指定したプリンタは、情報を取得するプリンタとしても使われるため、フォーム作成時と同じプリンタにすると、フォーム作成時と同じ状態で印刷やプレビューを行うことができます。フォーム作成時と異なるプリンタにした場合は、線の太さや文字の印字位置などが変わることがあります。
次の場合、こprnhdc の値は無効となります。
(1) jvSetDevMode
ファンクションでプリンタを設定した場合
(2) jvPrintDialogEx
ファンクションで印刷ダイアログを表示した場合
(3) 帳票をRDF形式で作成した場合。プリンタドライバからの情報取得は、作成時ではなく、プレビューコントロールによるプレビュー時に行われます。
帳票の幅と高さ
outdev が「JV_RDF」と「JV_BITMAPFILE」の場合に設定します。出力先デバイスがそれ以外の場合、この値は無視されます。
出力ファイル名
filename
は、RDF形式、ビットマップ形式、Adobe PDF形式の帳票をファイルに保存する時に、保存ファイル名を指定するためのパラメータです。
filename の値は、outdev
が「JV_RDF」「JV_BITMAPFILE」「JV_PDF」の場合に有効です。
−基本的なコーディング
−RDF形式で帳票をメモリ上に作成する
−Acobe PDF形式で帳票をメモリ上に作成する
−Adobe PDFドキュメントの制限