jvGetString

jvGetString（文字型情報取得）

各種の文字情報を取得します。

[構文]

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	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 の外で取得する時は、jid に 0 を指定します。

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)