jvGetString（文字型情報取得）

これは、旧バージョンの関数です。
旧バージョンとの互換性のため、及び、JAVAで開発するユーザーのために残されています。
JAVA以外で開発する場合には、jvGetStringEx を使ってください。
 
[構文]
 
Function jvGetString(ByVal jid As Long, ByVal mode As Long, ByVal rval As String)As Long
 
C言語
int jvGetString(int jid, int mode, char *rval);
 
JAVA
int jvGetString(int jid, nt mode, StringBuffer rval);
 
Delphi
Function jvGetString(jid, mode: Longint; rval: PAnsiChar): Longint;
   

設定項目

内容

jid

jvCreateで取得したジョブID

mode

取得する情報の種類（設定値参照）

rval

情報を取得するバッファ

 
リターンコード
 

定数

値

内容

 

0以上

取得した文字列の長さ

JV_ERR_JOBID

-3

ジョブ識別番号エラー

JV_ERR_PARAMETER

-2

パラメータエラー

 
[設定値]
 
mode には次の値を設定します。
 

定数

値

内容

JV_FORM_NAME

1

フォームファイル情報のフォームファイル名（33バイト以下）

JV_FORM_CREATOR

2

フォームファイル情報のフォーム作成者（33バイト以下）

JV_FORM_COMMENT

3

フォームファイル情報のフォームの説明（257バイト以下）

JV_PRINTER_NAME

4

印刷に使うプリンタ名称（33バイト以下）

JV_DEFAULT_PRINTER_NAME

6

標準プリンタの名前（33バイト以下）

JV_EMBEDERR_FONT

11

Adobe PDF形式のデータに埋め込めないフォント名（33バイト以下）

 
[解説]
 
jvGetString は文字情報を取得します。数値情報を取得する場合は、jvGetLong を使います。
  
rval は、取得する情報に応じたサイズを確保してください。
 
フォームファイル情報（JV_FORM_NAME/JV_FORM_CREATOR/JV_FORM_COMMENT）
フォームファイル情報は、jvSetForm でフォームを設定した後に取得してください。
   
印刷に使うプリンタ名称（JV_PRINTER_NAME）
プリンタ名称は、jvStartDoc から jvEndDoc の間で取得して下さい。取得したプリンタ名称は、jvGetJobStatus、jvGetJobInfo、jvGetAllJobInfo、jvSetJobStatusで使用できます。
jvCreate のプリンタデバイスコンテキストに 0 を指定した場合には、コントロールパネルで通常使うプリンタに設定されているプリンタ名称を取得します。特定のプリンタのデバイスコンテキストを指定した場合にはプリンタ名称を取得できません。
jvSetDevMode をプリンタ名を指定してコールした時は、同じプリンタ名称を取得します。
jvPrintDialogEx をコールして印刷ダイアログがポップアップされた場合には、印刷ダイアログでユーザーが選択したプリンタ名称を取得します。
 
標準プリンタの名前（JV_DEFAULT_PRINTER_NAME）
標準プリンタ名は、jvCreate と jvClose 間以外でも取得できます。jvCreate とjvClose の外で取得する時には、jvCreateで取得したジョブID（jid） には 0 を指定します。
 
Adobe PDF形式のデータに埋め込めないフォント名（JV_EMBEDERR_FONT）
Adobe PDF形式のデータを出力中、jvDrawForm 、jvSetString 、jvDrawGraph で「JV_ERR_FONTEMBED_FILE(-124)」エラーが発生した時に、エラーの原因となったフォント名を取得します。フォント名は、エラーが発生した直後のみ取得できます。
 
−Adpbe PDF形式データへフォントを埋め込む
   
[コーディング例]
 
Dim jid&, ret&
Dim rval$
rval = space(33)
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 = jvGetString(jid, JV_FORM_NAME, rval)
|
ret = jvEndPage(jid)
ret = jvEndDoc(jid)
ret = jvClose(jid)