OPEN PRINTING JOB

Home

4D v20.6

OPEN PRINTING JOB


	OPEN PRINTING JOB

	Does not require any parameters

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.

When a print job is opened with this command, the printer is placed in “busy” mode until the printing is actually launched. If a non compatible plug-in launches a print job in this context, the “printer busy” error is returned.

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 and the printer will not be available until you quit the 4D application.

The print job is local to the process but printing is performed at the global level. Only one print job can be open at a time in 4D, all processes taken together.

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).

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
another print job is already open
on Windows, the selected print preview format is not available