src/java.desktop/share/classes/java/awt/print/PrinterJob.java

Print this page




 507      *          to conform with this <code>PrinterJob</code>.
 508      */
 509     public abstract PageFormat validatePage(PageFormat page);
 510 
 511     /**
 512      * Prints a set of pages.
 513      * @exception PrinterException an error in the print system
 514      *            caused the job to be aborted.
 515      * @see Book
 516      * @see Pageable
 517      * @see Printable
 518      */
 519     public abstract void print() throws PrinterException;
 520 
 521    /**
 522      * Prints a set of pages using the settings in the attribute
 523      * set. The default implementation ignores the attribute set.
 524      * <p>
 525      * Note that some attributes may be set directly on the PrinterJob
 526      * by equivalent method calls, (for example), copies:
 527      * <code>setcopies(int)</code>, job name: <code>setJobName(String)</code>
 528      * and specifying media size and orientation though the
 529      * <code>PageFormat</code> object.
 530      * <p>
 531      * If a supported attribute-value is specified in this attribute set,
 532      * it will take precedence over the API settings for this print()
 533      * operation only.
 534      * The following behaviour is specified for PageFormat:
 535      * If a client uses the Printable interface, then the
 536      * <code>attributes</code> parameter to this method is examined
 537      * for attributes which specify media (by size), orientation, and
 538      * imageable area, and those are used to construct a new PageFormat
 539      * which is passed to the Printable object's print() method.
 540      * See {@link Printable} for an explanation of the required
 541      * behaviour of a Printable to ensure optimal printing via PrinterJob.
 542      * For clients of the Pageable interface, the PageFormat will always
 543      * be as supplied by that interface, on a per page basis.
 544      * <p>
 545      * These behaviours allow an application to directly pass the
 546      * user settings returned from
 547      * <code>printDialog(PrintRequestAttributeSet attributes</code> to




 507      *          to conform with this <code>PrinterJob</code>.
 508      */
 509     public abstract PageFormat validatePage(PageFormat page);
 510 
 511     /**
 512      * Prints a set of pages.
 513      * @exception PrinterException an error in the print system
 514      *            caused the job to be aborted.
 515      * @see Book
 516      * @see Pageable
 517      * @see Printable
 518      */
 519     public abstract void print() throws PrinterException;
 520 
 521    /**
 522      * Prints a set of pages using the settings in the attribute
 523      * set. The default implementation ignores the attribute set.
 524      * <p>
 525      * Note that some attributes may be set directly on the PrinterJob
 526      * by equivalent method calls, (for example), copies:
 527      * <code>setCopies(int)</code>, job name: <code>setJobName(String)</code>
 528      * and specifying media size and orientation though the
 529      * <code>PageFormat</code> object.
 530      * <p>
 531      * If a supported attribute-value is specified in this attribute set,
 532      * it will take precedence over the API settings for this print()
 533      * operation only.
 534      * The following behaviour is specified for PageFormat:
 535      * If a client uses the Printable interface, then the
 536      * <code>attributes</code> parameter to this method is examined
 537      * for attributes which specify media (by size), orientation, and
 538      * imageable area, and those are used to construct a new PageFormat
 539      * which is passed to the Printable object's print() method.
 540      * See {@link Printable} for an explanation of the required
 541      * behaviour of a Printable to ensure optimal printing via PrinterJob.
 542      * For clients of the Pageable interface, the PageFormat will always
 543      * be as supplied by that interface, on a per page basis.
 544      * <p>
 545      * These behaviours allow an application to directly pass the
 546      * user settings returned from
 547      * <code>printDialog(PrintRequestAttributeSet attributes</code> to