< prev index next >
src/java.desktop/share/classes/javax/print/DocPrintJob.java
Print this page
*** 43,53 ****
/**
* Determines the {@link PrintService} object to which this print job
* object is bound.
*
! * @return <code>PrintService</code> object.
*
*/
public PrintService getPrintService();
/**
--- 43,53 ----
/**
* Determines the {@link PrintService} object to which this print job
* object is bound.
*
! * @return {@code PrintService} object.
*
*/
public PrintService getPrintService();
/**
*** 56,66 ****
* The returned attribute set object is a "snapshot" of this Print Job's
* attribute set at the time of the {@link #getAttributes()} method
* call; that is, the returned attribute set's object's contents will
* not be updated if this Print Job's attribute set's contents change
* in the future. To detect changes in attribute values, call
! * <code>getAttributes()</code> again and compare the new attribute
* set to the previous attribute set; alternatively, register a
* listener for print job events.
* The returned value may be an empty set but should not be null.
* @return the print job attributes
*/
--- 56,66 ----
* The returned attribute set object is a "snapshot" of this Print Job's
* attribute set at the time of the {@link #getAttributes()} method
* call; that is, the returned attribute set's object's contents will
* not be updated if this Print Job's attribute set's contents change
* in the future. To detect changes in attribute values, call
! * {@code getAttributes()} again and compare the new attribute
* set to the previous attribute set; alternatively, register a
* listener for print job events.
* The returned value may be an empty set but should not be null.
* @return the print job attributes
*/
*** 94,104 ****
/**
* Registers a listener for changes in the specified attributes.
* If listener is null, no exception is thrown and no action is
* performed.
* To determine the attribute updates that may be reported by this job,
! * a client can call <code>getAttributes()</code> and identify the
* subset that are interesting and likely to be reported to the
* listener. Clients expecting to be updated about changes in a
* specific job attribute should verify it is in that set, but
* updates about an attribute will be made only if it changes and this
* is detected by the job. Also updates may be subject to batching
--- 94,104 ----
/**
* Registers a listener for changes in the specified attributes.
* If listener is null, no exception is thrown and no action is
* performed.
* To determine the attribute updates that may be reported by this job,
! * a client can call {@code getAttributes()} and identify the
* subset that are interesting and likely to be reported to the
* listener. Clients expecting to be updated about changes in a
* specific job attribute should verify it is in that set, but
* updates about an attribute will be made only if it changes and this
* is detected by the job. Also updates may be subject to batching
*** 150,160 ****
* should register a PrintJobListener.
* <p>
* Print service implementors should close any print data streams (ie
* Reader or InputStream implementations) that they obtain
* from the client doc. Robust clients may still wish to verify this.
! * An exception is always generated if a <code>DocFlavor</code> cannot
* be printed.
*
* @param doc The document to be printed. If must be a flavor
* supported by this PrintJob.
*
--- 150,160 ----
* should register a PrintJobListener.
* <p>
* Print service implementors should close any print data streams (ie
* Reader or InputStream implementations) that they obtain
* from the client doc. Robust clients may still wish to verify this.
! * An exception is always generated if a {@code DocFlavor} cannot
* be printed.
*
* @param doc The document to be printed. If must be a flavor
* supported by this PrintJob.
*
< prev index next >