ilog.views.print

Class IlvPrintableManagerArea

java.lang.Object

ilog.views.util.print.IlvPrintableObject

ilog.views.print.IlvPrintableManagerArea

All Implemented Interfaces:

Printable

public class IlvPrintableManagerArea
extends IlvPrintableObject

IlvPrintableManagerArea defines as printable object an area of a manager that can be printed.

Since:

JViews 5.5

Field Summary

Fields inherited from interface java.awt.print.Printable

NO_SUCH_PAGE, PAGE_EXISTS

Constructor Summary

Constructors

Constructor and Description
IlvPrintableManagerArea(IlvManagerView view, IlvUnit.Rectangle area, IlvRect printArea, double zoomLevel) Creates the IlvPrintableManagerArea.
IlvPrintableManagerArea(IlvManagerView view, IlvUnit.Rectangle area, IlvRect printArea, IlvTransformer zoomTransformer) Creates the IlvPrintableManagerArea.

Method Summary

Modifier and Type	Method and Description
IlvManagerView	getManagerView() Returns the manager view (IlvManagerView) that will be printed.
IlvRect	getPrintArea() Returns the area of the manager that will be printed.
static AffineTransform	getPrintTransformer(Rectangle2D.Double area, IlvRect printArea, IlvTransformer zoomTransformer) Returns the transformation that fits the printable area to the page.
boolean	isRespectingLayerVisibilityPerView() Returns true if the visibility of printed layers is determined from the visibility per view.
int	print(Graphics dst, PageFormat format, int pageIndex) Prints the area of the manager.
void	setRespectingLayerVisibilityPerView(boolean enable) Sets whether the visibility of printed layers is determined from the visibility per view.

Methods inherited from class ilog.views.util.print.IlvPrintableObject

getPage

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

IlvPrintableManagerArea

public IlvPrintableManagerArea(IlvManagerView view,
                               IlvUnit.Rectangle area,
                               IlvRect printArea,
                               IlvTransformer zoomTransformer)

Creates the IlvPrintableManagerArea.

The printing mechanism takes the antialiasing rendering hints from the input view. Furthermore, if it is respecting the layer visibility per view, then only the layers visible in the view are printed.

In the printout, the print area of the manager is transformed to fit to the page area.

The content of an IlvManager may change when displayed at different zoom level (for example when it contains nonzoomable objects). The input zoom transformer is used to specify the zoom level when printing. Still, the print area is transformed to fit to the page area, but the zoom transformer decides for instance how much of this transformation contributes to the nonzoomable objects. If the input zoom transformer is null, the zoom transformer of the input view is used instead. In this case, the proportions between zoomable and nonzoomable objects are in the printout exactly as in the view.

Parameters:

view - The manager view to print.

area - The area in the page where the manager must be printed.

printArea - The area of the manager to be printed in manager's coordinate system.

zoomTransformer - The transformation applied to the manager when printing.

Since:

JViews 8.0

See Also:

isRespectingLayerVisibilityPerView(), IlvManagerView.setAntialiasing(boolean)

IlvPrintableManagerArea

public IlvPrintableManagerArea(IlvManagerView view,
                               IlvUnit.Rectangle area,
                               IlvRect printArea,
                               double zoomLevel)

Creates the IlvPrintableManagerArea.

The printing mechanism takes the antialiasing rendering hints from the input view. Furthermore, if it is respecting the layer visibility per view, then only the layers visible in the view are printed.

In the printout, the print area of the manager is transformed to fit to the page area.

The content of an IlvManager may change when displayed at different zoom level (for example when it contains nonzoomable objects). Still, the print area is transformed to fit to the page area, but the zoom level decides how much of this transformation contributes to the nonzoomable objects.

Parameters:

view - The manager view to print.

area - The area in the page where the manager must be printed.

printArea - The area of the manager to be printed in manager's coordinate system.

zoomLevel - The zoom level to print.

See Also:

isRespectingLayerVisibilityPerView(), IlvManagerView.setAntialiasing(boolean)

Method Detail

getPrintTransformer

public static AffineTransform getPrintTransformer(Rectangle2D.Double area,
                                                  IlvRect printArea,
                                                  IlvTransformer zoomTransformer)

Returns the transformation that fits the printable area to the page.

In the printout, the print area of the manager is transformed to fit to the page area.

The content of an IlvManager may change when displayed at different zoom level (for example when it contains nonzoomable objects). The input zoom transformer is used to specify the zoom level when printing. Still, the print area is transformed to fit to the page area, but the zoom transformer decides how much of this transformation contributes to the nonzoomable objects. If the input zoom transformer is null, the zoom level 1 is used.

Parameters:

area - The area in the page where the manager must be printed.

printArea - The area of the manager to be printed in manager's coordinate system.

zoomTransformer - The transformation applied to the manager when printing.

Since:

JViews 8.0

getManagerView

public IlvManagerView getManagerView()

Returns the manager view (IlvManagerView) that will be printed.

getPrintArea

public IlvRect getPrintArea()

Returns the area of the manager that will be printed.

Returns:

the area in manager's coordinate system.

print

public int print(Graphics dst,
                 PageFormat format,
                 int pageIndex)
          throws PrinterException

Prints the area of the manager.

Parameters:

dst - The output Graphics object.

format - The page format, which is ignored here.

pageIndex - The page index, which is ignored here.

Throws:

PrinterException

setRespectingLayerVisibilityPerView

public void setRespectingLayerVisibilityPerView(boolean enable)

Sets whether the visibility of printed layers is determined from the visibility per view. The class IlvManager allows you to set layers invisible for all views, or invisible for specific views. Layers that are invisible for all views are never printed. If this option is disabled, layers that are invisible for a specific view are printed. If this option is enabled, they are not printed and the layer is invisible in the specific printed view.

The option is enabled by default. Disable this option to obtain the behavior of JViews 6.5 and earlier.

Since:

JViews 7.5

See Also:

isRespectingLayerVisibilityPerView(), IlvManager.setVisible(int, boolean, boolean), IlvManager.setVisible(ilog.views.IlvManagerView, int, boolean, boolean)

isRespectingLayerVisibilityPerView

public boolean isRespectingLayerVisibilityPerView()

Returns true if the visibility of printed layers is determined from the visibility per view.

Since:

JViews 7.5

See Also:

setRespectingLayerVisibilityPerView(boolean)