OPEN PRINTING JOB
OPEN PRINTING JOB
| Does not require any parameters |
|---|
This command is not thread-safe, it cannot be used in preemptive code.
Description
The OPEN PRINTING JOB command opens a print job and stacks all the subsequent printing orders there until the CLOSE PRINTING JOB command is called. This command lets you control the print jobs and, more particularly, ensure that no other unexpected print job can be inserted into a printing sequence.
The OPEN PRINTING JOB command can be used with all the 4D printing commands, the quick report commands, and the printing commands of 4D Write Pro and 4D View Pro.
The print job is local to the process, each process has its own printing settings (print options,current printer,etc.). Several print jobs can be open at the same time in 4D.
You must call the CLOSE PRINTING JOB command to terminate the print job and send the print document to the printer. If you omit this command, the print document will remain in the stack.
OPEN PRINTING JOB uses the current print settings (default settings or set using the SET PRINT OPTION command). The commands that modify the print settings must be called before OPEN PRINTING JOB, otherwise an error is generated (exception: the Orientation option can be called by the SET PRINT OPTION command within a print job).
Compatibility Note: Starting with 4D v20 R4, printing jobs are non-blocking in new projects. For more information, please refer to the Non-blocking printing option documentation in the Compatibility settings.
System variables and sets
The OK system variable is set to 1 if the print job has been successfully open. Otherwise, it is set to 0, for example in the followiing cases:
- the print job has been canceled by the user
- on Windows, the selected print preview format is not available