< 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 >