jvSetForm（フォーム指定）
描画するフォームを指定します。
[構文]
Function jvSetForm(ByVal jid As Long, ByVal formName As String, ByVal pageNo As Long, ByVal pageKey As String, ByVal scale As Long, ByVal mgX As Long, ByVal mgY As Long) As Long
C言語
int jvSetForm(int jid, char *formName, int pageNo, char *pageKey, int scale, int mgX, int mgY);
JAVA
int jvSetForm(int jid, String formName, int pageNo, String pageKey, int scale, int mgX, int mgY);
Delphi
Function jvSetForm(jid: Longint; formName: PAnsiChar; pageNo: Longint; pageKey: PAnsiChar; scale, mgX, mgY: Longint): Longint;
|
設定項目 |
内容 |
|
jid |
jvCreateで取得したジョブID |
|
formName |
フォームファイル名称 |
|
pageNo |
フォームのページ番号 |
|
pageKey |
フォームのページキー |
|
scale |
フォームの拡大縮小率（1%〜1000%） |
|
mgX |
フォームの横方向のマージン（1/100mm単位） |
|
mgY |
フォームの縦方向のマージン（1/100mm単位） |
リターンコード
|
定数 |
値 |
内容 |
|
|
0 |
正常終了 |
|
JV_ERR_JOBID |
-3 |
ジョブIDエラー |
|
JV_ERR_OPEN_FILE |
-42 |
ファイルオープンエラー |
|
JV_ERR_READ_FILE |
-43 |
ファイルリードエラー |
|
JV_ERR_FORM_FORMAT |
-40 |
フォームのフォーマットが違う |
|
JV_ERR_FORM_VERSION |
-41 |
フォームのバージョンが違う |
|
JV_ERR_MEMORY |
-4 |
メモリ関連エラー |
|
JV_ERR_PARAMETER |
-2 |
パラメータエラー |
|
JV_ERR_PAGENO |
-21 |
ページ番号指定エラー |
|
JV_ERR_PAGEKEY |
-22 |
ページキー指定エラー |
[解説]
jvSetFormがコールされるとjvSetFieldTextなどで設定したフィールドデータはクリアされます。
フォームファイル中に複数のフォームが保存されている場合には、pageNo
またはpageKey を使って使用するフォームを指定します。pageKey
を使う時には、pageNo
には0を指定します。
可変フォームでは、フォームファイル中に複数のフォームを作成することができないため、pageNo とpageKey
パラメータは無視されます。
scale
パラメータは、出力先がRDFファイル、RDFデータ、Adobe PDFドキュメントの場合には無視されます。
RDFファイル、RDFデータの場合、拡大縮小率の設定にはプレビューコントロールのScaleプロパティを使います。
Adobe PDFドキュメントの場合、拡大縮小率の設定にはAdobe Readerの機能を使います。
[コーディング例]
Dim jid&, ret&
jid = jvCreate(JV_PRINTER, form1.hWnd, Printer.hDC,
0, 0, 0, "")
ret = jvSetForm(jid, "c:\JiveReport\納品書.jfm", 1, "",
100, 0, 0)
ret = jvStartDoc(jid, "納品書", "")
|
ret = jvDrawForm(jid, JV_FORM_ONLY)
ret = jvEndPage(jid)
ret = jvEndDoc(jid)
ret = jvClose(jid)