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
|