java.awt.print
Interface Pageable

All Known Implementing Classes:
Book sample code for java.awt.print.Book definition code for java.awt.print.Book

public interface Pageable

The Pageable implementation represents a set of pages to be printed. The Pageable object returns the total number of pages in the set as well as the PageFormat sample code for java.awt.print.PageFormat definition code for java.awt.print.PageFormat and Printable sample code for java.awt.print.Printable definition code for java.awt.print.Printable for a specified page.

See Also:
PageFormat sample code for java.awt.print.PageFormat definition code for java.awt.print.PageFormat , Printable sample code for java.awt.print.Printable definition code for java.awt.print.Printable

Field Summary
static int UNKNOWN_NUMBER_OF_PAGES sample code for java.awt.print.Pageable.UNKNOWN_NUMBER_OF_PAGES definition code for java.awt.print.Pageable.UNKNOWN_NUMBER_OF_PAGES
          This constant is returned from the getNumberOfPages sample code for java.awt.print.Pageable.getNumberOfPages() definition code for java.awt.print.Pageable.getNumberOfPages() method if a Pageable implementation does not know the number of pages in its set.
 
Method Summary
 int getNumberOfPages sample code for java.awt.print.Pageable.getNumberOfPages() definition code for java.awt.print.Pageable.getNumberOfPages() ()
          Returns the number of pages in the set.
 PageFormat sample code for java.awt.print.PageFormat definition code for java.awt.print.PageFormat getPageFormat sample code for java.awt.print.Pageable.getPageFormat(int) definition code for java.awt.print.Pageable.getPageFormat(int) (int pageIndex)
          Returns the PageFormat of the page specified by pageIndex.
 Printable sample code for java.awt.print.Printable definition code for java.awt.print.Printable getPrintable sample code for java.awt.print.Pageable.getPrintable(int) definition code for java.awt.print.Pageable.getPrintable(int) (int pageIndex)
          Returns the Printable instance responsible for rendering the page specified by pageIndex.
 

Field Detail

UNKNOWN_NUMBER_OF_PAGES sample code for java.awt.print.Pageable.UNKNOWN_NUMBER_OF_PAGES

static final int UNKNOWN_NUMBER_OF_PAGES
This constant is returned from the getNumberOfPages sample code for java.awt.print.Pageable.getNumberOfPages() definition code for java.awt.print.Pageable.getNumberOfPages() method if a Pageable implementation does not know the number of pages in its set.

See Also:
Constant Field Values
Method Detail

getNumberOfPages sample code for java.awt.print.Pageable.getNumberOfPages() definition code for java.awt.print.Pageable.getNumberOfPages()

int getNumberOfPages()
Returns the number of pages in the set. To enable advanced printing features, it is recommended that Pageable implementations return the true number of pages rather than the UNKNOWN_NUMBER_OF_PAGES constant.

Returns:
the number of pages in this Pageable.

getPageFormat sample code for java.awt.print.Pageable.getPageFormat(int) definition code for java.awt.print.Pageable.getPageFormat(int)

PageFormat sample code for java.awt.print.PageFormat definition code for java.awt.print.PageFormat  getPageFormat(int pageIndex)
                         throws IndexOutOfBoundsException sample code for java.lang.IndexOutOfBoundsException definition code for java.lang.IndexOutOfBoundsException 
Returns the PageFormat of the page specified by pageIndex.

Parameters:
pageIndex - the zero based index of the page whose PageFormat is being requested
Returns:
the PageFormat describing the size and orientation.
Throws:
IndexOutOfBoundsException sample code for java.lang.IndexOutOfBoundsException definition code for java.lang.IndexOutOfBoundsException - if the Pageable does not contain the requested page.

getPrintable sample code for java.awt.print.Pageable.getPrintable(int) definition code for java.awt.print.Pageable.getPrintable(int)

Printable sample code for java.awt.print.Printable definition code for java.awt.print.Printable  getPrintable(int pageIndex)
                       throws IndexOutOfBoundsException sample code for java.lang.IndexOutOfBoundsException definition code for java.lang.IndexOutOfBoundsException 
Returns the Printable instance responsible for rendering the page specified by pageIndex.

Parameters:
pageIndex - the zero based index of the page whose Printable is being requested
Returns:
the Printable that renders the page.
Throws:
IndexOutOfBoundsException sample code for java.lang.IndexOutOfBoundsException definition code for java.lang.IndexOutOfBoundsException - if the Pageable does not contain the requested page.