< prev index next >

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

Print this page

        

*** 26,36 **** package java.awt.print; import java.util.Vector; /** ! * The <code>Book</code> class provides a representation of a document in * which pages may have different page formats and page painters. This * class uses the {@link Pageable} interface to interact with a * {@link PrinterJob}. * @see Pageable * @see PrinterJob --- 26,36 ---- package java.awt.print; import java.util.Vector; /** ! * The {@code Book} class provides a representation of a document in * which pages may have different page formats and page painters. This * class uses the {@link Pageable} interface to interact with a * {@link PrinterJob}. * @see Pageable * @see PrinterJob
*** 50,116 **** private Vector<BookPage> mPages; /* Instance Methods */ /** ! * Creates a new, empty <code>Book</code>. */ public Book() { mPages = new Vector<>(); } /** ! * Returns the number of pages in this <code>Book</code>. ! * @return the number of pages this <code>Book</code> contains. */ public int getNumberOfPages(){ return mPages.size(); } /** * Returns the {@link PageFormat} of the page specified by ! * <code>pageIndex</code>. * @param pageIndex the zero based index of the page whose ! * <code>PageFormat</code> is being requested ! * @return the <code>PageFormat</code> describing the size and * orientation of the page. ! * @throws IndexOutOfBoundsException if the <code>Pageable</code> * does not contain the requested page */ public PageFormat getPageFormat(int pageIndex) throws IndexOutOfBoundsException { return getPage(pageIndex).getPageFormat(); } /** * Returns the {@link Printable} instance responsible for rendering ! * the page specified by <code>pageIndex</code>. * @param pageIndex the zero based index of the page whose ! * <code>Printable</code> is being requested ! * @return the <code>Printable</code> that renders the page. ! * @throws IndexOutOfBoundsException if the <code>Pageable</code> * does not contain the requested page */ public Printable getPrintable(int pageIndex) throws IndexOutOfBoundsException { return getPage(pageIndex).getPrintable(); } /** ! * Sets the <code>PageFormat</code> and the <code>Painter</code> for a * specified page number. * @param pageIndex the zero based index of the page whose * painter and format is altered ! * @param painter the <code>Printable</code> instance that * renders the page * @param page the size and orientation of the page * @throws IndexOutOfBoundsException if the specified ! * page is not already in this <code>Book</code> ! * @throws NullPointerException if the <code>painter</code> or ! * <code>page</code> argument is <code>null</code> */ public void setPage(int pageIndex, Printable painter, PageFormat page) throws IndexOutOfBoundsException { if (painter == null) { --- 50,116 ---- private Vector<BookPage> mPages; /* Instance Methods */ /** ! * Creates a new, empty {@code Book}. */ public Book() { mPages = new Vector<>(); } /** ! * Returns the number of pages in this {@code Book}. ! * @return the number of pages this {@code Book} contains. */ public int getNumberOfPages(){ return mPages.size(); } /** * Returns the {@link PageFormat} of the page specified by ! * {@code pageIndex}. * @param pageIndex the zero based index of the page whose ! * {@code PageFormat} is being requested ! * @return the {@code PageFormat} describing the size and * orientation of the page. ! * @throws IndexOutOfBoundsException if the {@code Pageable} * does not contain the requested page */ public PageFormat getPageFormat(int pageIndex) throws IndexOutOfBoundsException { return getPage(pageIndex).getPageFormat(); } /** * Returns the {@link Printable} instance responsible for rendering ! * the page specified by {@code pageIndex}. * @param pageIndex the zero based index of the page whose ! * {@code Printable} is being requested ! * @return the {@code Printable} that renders the page. ! * @throws IndexOutOfBoundsException if the {@code Pageable} * does not contain the requested page */ public Printable getPrintable(int pageIndex) throws IndexOutOfBoundsException { return getPage(pageIndex).getPrintable(); } /** ! * Sets the {@code PageFormat} and the {@code Painter} for a * specified page number. * @param pageIndex the zero based index of the page whose * painter and format is altered ! * @param painter the {@code Printable} instance that * renders the page * @param page the size and orientation of the page * @throws IndexOutOfBoundsException if the specified ! * page is not already in this {@code Book} ! * @throws NullPointerException if the {@code painter} or ! * {@code page} argument is {@code null} */ public void setPage(int pageIndex, Printable painter, PageFormat page) throws IndexOutOfBoundsException { if (painter == null) {
*** 123,156 **** mPages.setElementAt(new BookPage(painter, page), pageIndex); } /** ! * Appends a single page to the end of this <code>Book</code>. ! * @param painter the <code>Printable</code> instance that * renders the page * @param page the size and orientation of the page * @throws NullPointerException ! * If the <code>painter</code> or <code>page</code> ! * argument is <code>null</code> */ public void append(Printable painter, PageFormat page) { mPages.addElement(new BookPage(painter, page)); } /** ! * Appends <code>numPages</code> pages to the end of this ! * <code>Book</code>. Each of the pages is associated with ! * <code>page</code>. ! * @param painter the <code>Printable</code> instance that renders * the page * @param page the size and orientation of the page * @param numPages the number of pages to be added to the ! * this <code>Book</code>. * @throws NullPointerException ! * If the <code>painter</code> or <code>page</code> ! * argument is <code>null</code> */ public void append(Printable painter, PageFormat page, int numPages) { BookPage bookPage = new BookPage(painter, page); int pageIndex = mPages.size(); int newSize = pageIndex + numPages; --- 123,156 ---- mPages.setElementAt(new BookPage(painter, page), pageIndex); } /** ! * Appends a single page to the end of this {@code Book}. ! * @param painter the {@code Printable} instance that * renders the page * @param page the size and orientation of the page * @throws NullPointerException ! * If the {@code painter} or {@code page} ! * argument is {@code null} */ public void append(Printable painter, PageFormat page) { mPages.addElement(new BookPage(painter, page)); } /** ! * Appends {@code numPages} pages to the end of this ! * {@code Book}. Each of the pages is associated with ! * {@code page}. ! * @param painter the {@code Printable} instance that renders * the page * @param page the size and orientation of the page * @param numPages the number of pages to be added to the ! * this {@code Book}. * @throws NullPointerException ! * If the {@code painter} or {@code page} ! * argument is {@code null} */ public void append(Printable painter, PageFormat page, int numPages) { BookPage bookPage = new BookPage(painter, page); int pageIndex = mPages.size(); int newSize = pageIndex + numPages;
*** 188,199 **** /** * A new instance where 'format' describes the page's * size and orientation and 'painter' is the instance * that will draw the page's graphics. * @throws NullPointerException ! * If the <code>painter</code> or <code>format</code> ! * argument is <code>null</code> */ BookPage(Printable painter, PageFormat format) { if (painter == null || format == null) { throw new NullPointerException(); --- 188,199 ---- /** * A new instance where 'format' describes the page's * size and orientation and 'painter' is the instance * that will draw the page's graphics. * @throws NullPointerException ! * If the {@code painter} or {@code format} ! * argument is {@code null} */ BookPage(Printable painter, PageFormat format) { if (painter == null || format == null) { throw new NullPointerException();
< prev index next >