Module java.desktop

Package javax.print

Interface MultiDocPrintJob

All Superinterfaces:

DocPrintJob

public interface MultiDocPrintJob
extends DocPrintJob

Obtained from a MultiDocPrintService, a MultiDocPrintJob can print a specified collection of documents as a single print job with a set of job attributes.

Method Summary

Modifier and Type	Method	Description
void	print(MultiDoc multiDoc, PrintRequestAttributeSet attributes)	Print a MultiDoc with the specified job attributes.

Methods inherited from interface javax.print.DocPrintJob

addPrintJobAttributeListener, addPrintJobListener, getAttributes, getPrintService, print, removePrintJobAttributeListener, removePrintJobListener

Method Detail

print

void print(MultiDoc multiDoc,
           PrintRequestAttributeSet attributes)
    throws PrintException

Print a MultiDoc with the specified job attributes. This method should only be called once for a given print job. Calling it again will not result in a new job being spooled to the printer. The service implementation will define policy for service interruption and recovery. Application clients which want to monitor the success or failure should register a PrintJobListener.

Parameters:

multiDoc - The documents to be printed. ALL must be a flavor supported by the PrintJob & PrintService.

attributes - The job attributes to be applied to this print job. If this parameter is null then the default attributes are used.

Throws:

PrintException - The exception additionally may implement an interfaces which more precisely describes the cause of the exception

• FlavorException. If the document has a flavor not supported by this print job.
• AttributeException. If one or more of the attributes are not valid for this print job.