jvStartDoc（文書開始）

印刷ジョブを開始します。

[構文]
 
Function jvStartDoc(ByVal jid As Long, ByVal docName As String, ByVal outFileName As String) As Long
 
C言語
int jvStartDoc(int jid, char *docName, char *outFileName);
 
JAVA
int jvStartDoc(int jid, String docName, String outFileName);
 
Delphi
Function jvStartDoc(jid: Longint; docName, outFileName: PAnsiChar): Longint;
 

設定項目

内容

jid

jvCreateで取得したジョブID

docName

ドキュメント名

outFileName

プリンタ言語ファイル名

 
リターンコード
 

定数

値

内容

 

0

正常終了

JV_ERR_JOBID

-3

ジョブIDエラー

JV_ERR_OPEN_NOT_EXEC

-30

jvCreateが実行されていない

JV_ERR_STARTDOC_ALREADY_EXEC

-31

STARTDOC済み

JV_ERR_CREATEDC

-13

デバイスコンテキスト作成エラー

JV_ERR_STARTDOC

-14

印刷開始エラー

 
[解説]
 
jvStartDocは、jvEndDocと対になるようにコーディングしてください。
 
ドキュメント名
docName は、jvCreateの出力先デバイスが「JV_PRINTER」の場合には、スプーラに表示される印刷ジョブのドキュメント名となります。出力先デバイスが「JV_PDF」の場合には、Adobe PDFドキュメントのドキュメント名となります。出力先デバイスがそれ以外の場合、docName は無効です。
 
出力ファイル名
outFileName は、出力結果をプリンタ言語ファイルとして保存する時にファイル名を指定するパラメータです。jvCreateの出力先デバイスには「JV_PRINTER」を指定します。ファイル保存機能がないプリンタドライバでは、この機能は使用できません。
旧バージョンのjvCreateBitmapファンクションを使用している場合は、outFileName にビットマップファイル名を指定します。