com.itextpdf.layout.renderer

Class MulticolRenderer

java.lang.Object

com.itextpdf.layout.renderer.AbstractRenderer

com.itextpdf.layout.renderer.MulticolRenderer

All Implemented Interfaces:

IPropertyContainer, IRenderer

public class MulticolRenderer
extends AbstractRenderer

Represents a renderer for columns.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	MulticolRenderer.ColumnHeightCalculator Interface which used for additional height calculation
static class	MulticolRenderer.LayoutInInfiniteHeightCalculator Default implementation of MulticolRenderer.ColumnHeightCalculator which allows 4 relayouts and performs simple additional height calculation (split the elements which don't fit).
static class	MulticolRenderer.MulticolLayoutResult Represents result of one iteration of MulticolRenderer layouting It contains split renderers which were lauded on a given height and overflow renderer for which height should be increased, so it can be lauded.

Field Summary

Fields inherited from class com.itextpdf.layout.renderer.AbstractRenderer

childRenderers, EPS, flushed, INF, isLastRendererForModelElement, modelElement, occupiedArea, OVERLAP_EPSILON, parent, positionedRenderers, properties

Constructor Summary

Constructors

Constructor and Description
MulticolRenderer(MulticolContainer modelElement) Creates a DivRenderer from its corresponding layout object.

Method Summary

Modifier and Type	Method and Description
protected AbstractRenderer	createOverflowRenderer(IRenderer overflowedContentRenderer) Creates an overflow renderer.
void	drawBorder(DrawContext drawContext) Performs the drawing operation for the border of this renderer, if defined by the Property.BORDER_TOP, Property.BORDER_RIGHT, Property.BORDER_BOTTOM and Property.BORDER_LEFT values in either the layout element or this IRenderer itself.
IRenderer	getNextRenderer() Gets a new instance of this class to be used as a next renderer, after this renderer is used, if IRenderer.layout(LayoutContext) is called more than once.
LayoutResult	layout(LayoutContext layoutContext) This method simulates positioning of the renderer, including all of its children, and returns the LayoutResult, representing the layout result, including occupied area, status, i.e.
protected MulticolRenderer.MulticolLayoutResult	layoutInColumns(LayoutContext layoutContext, Rectangle actualBBox) Layouts multicol in the passed area.
void	setHeightCalculator(MulticolRenderer.ColumnHeightCalculator heightCalculator) Sets the height calculator to be used by this renderer.

Methods inherited from class com.itextpdf.layout.renderer.AbstractRenderer

addAllProperties, addChild, alignChildHorizontally, allowLastYLineRecursiveExtraction, applyAbsolutePosition, applyAction, applyBorderBox, applyBorderBox, applyDestination, applyDestinationsAndAnnotation, applyLinkAnnotation, applyMargins, applyMargins, applyPaddings, applyPaddings, applyRelativePositioningTranslation, beginElementOpacityApplying, beginTransformationIfApplied, calculateAbsolutePdfBBox, calculateBBox, calculateShiftToPositionBBoxOfPointsAt, clipBackgroundArea, clipBackgroundArea, clipBorderArea, createXObject, deleteOwnProperty, deleteProperty, draw, drawBackground, drawChildren, endElementOpacityApplying, endTransformationIfApplied, getBackgroundArea, getBorderAreaBBox, getBorderRadii, getBorders, getChildRenderers, getDefaultProperty, getFirstYLineRecursively, getInnerAreaBBox, getLastYLineRecursively, getMargins, getMinMaxWidth, getMinMaxWidth, getModelElement, getOccupiedArea, getOccupiedAreaBBox, getOwnProperties, getOwnProperty, getPaddings, getParent, getProperty, getProperty, getPropertyAsBoolean, getPropertyAsColor, getPropertyAsFloat, getPropertyAsFloat, getPropertyAsFont, getPropertyAsInteger, getPropertyAsTransparentColor, getPropertyAsUnitValue, hasAbsoluteUnitValue, hasOwnOrModelProperty, hasOwnProperty, hasProperty, hasRelativeUnitValue, initElementAreas, isAbsolutePosition, isBorderBoxSizing, isFirstOnRootArea, isFixedLayout, isFlushed, isKeepTogether, isNotFittingHeight, isNotFittingLayoutArea, isNotFittingWidth, isOverflowFit, isOverflowProperty, isOverflowProperty, isOverflowProperty, isPositioned, isRelativePosition, isStaticLayout, move, rectangleToPointsList, retrieveHeight, retrieveMaxHeight, retrieveMaxWidth, retrieveMinHeight, retrieveMinWidth, retrieveResolvedDeclaredHeight, retrieveUnitValue, retrieveUnitValue, retrieveWidth, setBorders, setMinMaxWidthBasedOnFixedWidth, setParent, setProperty, toString, transformPoints, updateHeight, updateHeightsOnSplit, updateMaxHeight, updateMinHeight, updateWidth

Methods inherited from class java.lang.Object

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

Constructor Detail

MulticolRenderer

public MulticolRenderer(MulticolContainer modelElement)

Creates a DivRenderer from its corresponding layout object.

Parameters:

modelElement - the MulticolContainer which this object should manage

Method Detail

setHeightCalculator

public final void setHeightCalculator(MulticolRenderer.ColumnHeightCalculator heightCalculator)

Sets the height calculator to be used by this renderer.

Parameters:

heightCalculator - the height calculator to be used by this renderer.

layout

public LayoutResult layout(LayoutContext layoutContext)

This method simulates positioning of the renderer, including all of its children, and returns the LayoutResult, representing the layout result, including occupied area, status, i.e. if there was enough place to fit the renderer subtree, etc. LayoutResult can be extended to return custom layout results for custom elements, e.g. TextRenderer uses TextLayoutResult as its result. This method can be called standalone to learn how much area the renderer subtree needs, or can be called before IRenderer.draw(DrawContext), to prepare the renderer to be flushed to the output stream.

Parameters:

layoutContext - the description of layout area and any other additional information

Returns:

result of the layout process

getNextRenderer

public IRenderer getNextRenderer()

Gets a new instance of this class to be used as a next renderer, after this renderer is used, if IRenderer.layout(LayoutContext) is called more than once.

Returns:

new renderer instance

drawBorder

public void drawBorder(DrawContext drawContext)

Performs the drawing operation for the border of this renderer, if defined by the Property.BORDER_TOP, Property.BORDER_RIGHT, Property.BORDER_BOTTOM and Property.BORDER_LEFT values in either the layout element or this IRenderer itself.

Overrides:

drawBorder in class AbstractRenderer

Parameters:

drawContext - the context (canvas, document, etc) of this drawing operation.

layoutInColumns

protected MulticolRenderer.MulticolLayoutResult layoutInColumns(LayoutContext layoutContext,
                                                                Rectangle actualBBox)

Layouts multicol in the passed area.

Parameters:

layoutContext - the layout context

actualBBox - the area to layout multicol on

Returns:

the MulticolRenderer.MulticolLayoutResult instance

createOverflowRenderer

protected AbstractRenderer createOverflowRenderer(IRenderer overflowedContentRenderer)

Creates an overflow renderer.

Parameters:

overflowedContentRenderer - an overflowed content renderer

Returns:

a new AbstractRenderer instance