JViews Framework provides a document class,
IlvManagerPrintableDocument, which is a subclass of the generic
IlvPrintableDocument
class.
The
IlvManagerPrintableDocument
class is
dedicated to printing the contents of a manager on multiple pages.
When using the IlvManagerPrintableDocument
class,
you do not have to create pages and add them to the document. This
class will create the pages for you, depending on the parameters you
specify for the document.
In addition to the generic parameters defined in the
superclass
IlvPrintableDocument such as the name and author of the document, the
page format, the header and footer, and the page order, the
IlvManagerPrintableDocument
class
allows you to specify the following options:
The following code creates an instance of IlvManagerPrintableDocument
to
print the area (0,0,500,500) of a manager in five columns:
IlvManagerPrintableDocument document = new IlvPrintableManagerDocument
("My Document", view);
document.setColumnCount(5);
document.setPrintArea(new IlvRect(0,0,500,500));
Number of pages
The number of pages is determined by the number of rows
and columns that you specify as follows:
If you specify the number of rows, the
document computes the number of columns necessary to cover the area
to print.
If you specify both the number of rows
and the number of columns, then the document class will choose to
use the number of rows or the number of columns to produce the minimum
number of pages.
To print the manager on one page, set the number of rows
and the number of columns to 1.
Area to print
The area of the manager to print is specified by the setPrintArea
and getPrintArea
methods.
When no print area has been specified, then the printed area will
be the full area of the manager. To reset the area to print to the
full area of the manager, call:
document.setPrintArea(null);
Zoom Level for Printing
The contents of the manager may be graphically different
when a different zoom level is used, in particular when the manager
contains nonzoomable objects. Thus, when printing the manager, you
may need to specify the zoom level used for printing. By default,
the contents of the manager are printed using the identity affine
transform (that is, zoom level 1).