Description
The collection of wait functions allows you to synchronize and control the flow of documents being printed with your application. The WaitForJobsPrinted method should be called after the document has been printed and WaitForJobsSpooling has been called to verify that a print job actually entered the printer queue.
There is a distinction between when the document finishes printing and when the output file is complete.The document can be printed and have left the print queue before the printer has finished creating the output file; this difference is minimal and only becomes apparent in automation code when trying to use the output file before the printer has finished creating it.
Depending on the behaviour of the printing application this method may not need to be called at all. One example of this is the Microsoft Word automation object where background printing and the BackgroundPrintingStatus flag can be used to determine when the file has been completely spooled to the printer and it is safe to close the document and/or the application. In comparison, other applications may need to wait for the entire file to completely printed before it is safe to close both the file and the application.
Syntax
expression.WaitForJobsPrinted(Timeout)
where expression is an IPNPrintSession object.
Returns Boolean True if the print job has completed printing within the timeout period, and False if it did not.
Parameters
Integer Timeout
The length of time, in milliseconds, to wait for the print job to be printed.
See Also: WaitForJobsSpooling WaitForJobsSpooled WaitForJobsCompleted
