com.itextpdf.layout

Class Document

java.lang.Object

com.itextpdf.layout.ElementPropertyContainer

com.itextpdf.layout.RootElement<Document>

com.itextpdf.layout.Document

All Implemented Interfaces:

IPropertyContainer, Closeable, AutoCloseable

public class Document
extends RootElement<Document>

Document is the default root element when creating a self-sufficient PDF. It mainly operates high-level operations e.g. setting page size and rotation, adding elements, and writing text at specific coordinates. It has no knowledge of the actual PDF concepts and syntax.

A Document's rendering behavior can be modified by extending DocumentRenderer and setting an instance of this newly created with setRenderer(com.itextpdf.layout.renderer.DocumentRenderer).

Field Summary

Fields

Modifier and Type	Field and Description
protected float	bottomMargin Deprecated. To be removed in 7.2. Use Property.MARGIN_BOTTOM instead.
protected float	leftMargin Deprecated. To be removed in 7.2. Use Property.MARGIN_LEFT instead.
protected float	rightMargin Deprecated. To be removed in 7.2. Use Property.MARGIN_RIGHT instead.
protected float	topMargin Deprecated. To be removed in 7.2. Use Property.MARGIN_TOP instead.

Fields inherited from class com.itextpdf.layout.RootElement

childElements, defaultFont, defaultFontProvider, defaultSplitCharacters, immediateFlush, pdfDocument, rootRenderer

Fields inherited from class com.itextpdf.layout.ElementPropertyContainer

properties

Constructor Summary

Constructors

Constructor and Description
Document(PdfDocument pdfDoc) Creates a document from a PdfDocument.
Document(PdfDocument pdfDoc, PageSize pageSize) Creates a document from a PdfDocument with a manually set PageSize.
Document(PdfDocument pdfDoc, PageSize pageSize, boolean immediateFlush) Creates a document from a PdfDocument with a manually set PageSize.

Method Summary

Modifier and Type	Method and Description
Document	add(AreaBreak areaBreak) Terminates the current element, usually a page.
Document	add(IBlockElement element) Adds an element to the root.
protected void	checkClosingStatus() Checks whether a method is invoked at the closed document
void	close() Closes the document and associated PdfDocument.
protected RootRenderer	ensureRootRendererNotNull()
void	flush() Forces all registered renderers (including child element renderers) to flush their contents to the content stream.
float	getBottomMargin() Gets the bottom margin, measured in points
T1	getDefaultProperty(int property) Gets the default property from this entity.
float	getLeftMargin() Gets the left margin, measured in points
Rectangle	getPageEffectiveArea(PageSize pageSize) Returns the area that will actually be used to write on the page, given the current margins.
PdfDocument	getPdfDocument() Gets PDF document.
float	getRightMargin() Gets the right margin, measured in points
float	getTopMargin() Gets the top margin, measured in points
void	relayout() Performs an entire recalculation of the document flow, taking into account all its current child elements.
void	setBottomMargin(float bottomMargin) Sets the bottom margin, measured in points
void	setLeftMargin(float leftMargin) Sets the left margin, measured in points
void	setMargins(float topMargin, float rightMargin, float bottomMargin, float leftMargin) Convenience method to set all margins with one method.
void	setRenderer(DocumentRenderer documentRenderer) Changes the DocumentRenderer at runtime.
void	setRightMargin(float rightMargin) Sets the right margin, measured in points
void	setTopMargin(float topMargin) Sets the top margin, measured in points

Methods inherited from class com.itextpdf.layout.RootElement

add, createAndAddRendererSubTree, deleteOwnProperty, getFontProvider, getOwnProperty, getProperty, getRenderer, hasOwnProperty, hasProperty, setFontProvider, setProperty, showTextAligned, showTextAligned, showTextAligned, showTextAligned, showTextAligned, showTextAligned, showTextAlignedKerned

Methods inherited from class com.itextpdf.layout.ElementPropertyContainer

getSplitCharacters, getStrokeColor, getStrokeWidth, getTextRenderingMode, setBackgroundColor, setBackgroundColor, setBackgroundColor, setBackgroundColor, setBackgroundImage, setBackgroundImage, setBaseDirection, setBold, setBorder, setBorderBottom, setBorderBottomLeftRadius, setBorderBottomRightRadius, setBorderLeft, setBorderRadius, setBorderRight, setBorderTop, setBorderTopLeftRadius, setBorderTopRightRadius, setCharacterSpacing, setDestination, setFixedPosition, setFixedPosition, setFixedPosition, setFixedPosition, setFont, setFont, setFontColor, setFontColor, setFontFamily, setFontFamily, setFontKerning, setFontScript, setFontSize, setHorizontalAlignment, setHyphenation, setItalic, setLineThrough, setOpacity, setRelativePosition, setSplitCharacters, setStrokeColor, setStrokeWidth, setTextAlignment, setTextRenderingMode, setUnderline, setUnderline, setUnderline, setUnderline, setWordSpacing

Methods inherited from class java.lang.Object

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

Field Detail

leftMargin

@Deprecated
protected float leftMargin

Deprecated. To be removed in 7.2. Use Property.MARGIN_LEFT instead.

rightMargin

@Deprecated
protected float rightMargin

Deprecated. To be removed in 7.2. Use Property.MARGIN_RIGHT instead.

topMargin

@Deprecated
protected float topMargin

Deprecated. To be removed in 7.2. Use Property.MARGIN_TOP instead.

bottomMargin

@Deprecated
protected float bottomMargin

Deprecated. To be removed in 7.2. Use Property.MARGIN_BOTTOM instead.

Constructor Detail

Document

public Document(PdfDocument pdfDoc)

Creates a document from a PdfDocument. Initializes the first page with the PdfDocument's current default PageSize.

Parameters:

pdfDoc - the in-memory representation of the PDF document

Document

public Document(PdfDocument pdfDoc,
                PageSize pageSize)

Creates a document from a PdfDocument with a manually set PageSize.

Parameters:

pdfDoc - the in-memory representation of the PDF document

pageSize - the page size

Document

public Document(PdfDocument pdfDoc,
                PageSize pageSize,
                boolean immediateFlush)

Creates a document from a PdfDocument with a manually set PageSize.

Parameters:

pdfDoc - the in-memory representation of the PDF document

pageSize - the page size

immediateFlush - if true, write pages and page-related instructions to the PdfDocument as soon as possible.

Method Detail

close

public void close()

Closes the document and associated PdfDocument.

add

public Document add(AreaBreak areaBreak)

Terminates the current element, usually a page. Sets the next element to be the size specified in the argument.

Parameters:

areaBreak - an AreaBreak, optionally with a specified size

Returns:

this element

add

public Document add(IBlockElement element)

Description copied from class: RootElement

Adds an element to the root. The element is immediately placed in the contents.

Overrides:

add in class RootElement<Document>

Parameters:

element - an element with spacial margins, tabbing, and alignment

Returns:

this element

See Also:

BlockElement

getPdfDocument

public PdfDocument getPdfDocument()

Gets PDF document.

Returns:

the in-memory representation of the PDF document

setRenderer

public void setRenderer(DocumentRenderer documentRenderer)

Changes the DocumentRenderer at runtime. Use this to customize the Document's IRenderer behavior.

Parameters:

documentRenderer - the DocumentRenderer to set

flush

public void flush()

Forces all registered renderers (including child element renderers) to flush their contents to the content stream.

relayout

public void relayout()

Performs an entire recalculation of the document flow, taking into account all its current child elements. May become very resource-intensive for large documents.

Do not use when you have set RootElement.immediateFlush to true.

getLeftMargin

public float getLeftMargin()

Gets the left margin, measured in points

Returns:

a float containing the left margin value

setLeftMargin

public void setLeftMargin(float leftMargin)

Sets the left margin, measured in points

Parameters:

leftMargin - a float containing the new left margin value

getRightMargin

public float getRightMargin()

Gets the right margin, measured in points

Returns:

a float containing the right margin value

setRightMargin

public void setRightMargin(float rightMargin)

Sets the right margin, measured in points

Parameters:

rightMargin - a float containing the new right margin value

getTopMargin

public float getTopMargin()

Gets the top margin, measured in points

Returns:

a float containing the top margin value

setTopMargin

public void setTopMargin(float topMargin)

Sets the top margin, measured in points

Parameters:

topMargin - a float containing the new top margin value

getBottomMargin

public float getBottomMargin()

Gets the bottom margin, measured in points

Returns:

a float containing the bottom margin value

setBottomMargin

public void setBottomMargin(float bottomMargin)

Sets the bottom margin, measured in points

Parameters:

bottomMargin - a float containing the new bottom margin value

setMargins

public void setMargins(float topMargin,
                       float rightMargin,
                       float bottomMargin,
                       float leftMargin)

Convenience method to set all margins with one method.

Parameters:

topMargin - the upper margin

rightMargin - the right margin

leftMargin - the left margin

bottomMargin - the lower margin

getPageEffectiveArea

public Rectangle getPageEffectiveArea(PageSize pageSize)

Returns the area that will actually be used to write on the page, given the current margins. Does not have any side effects on the document.

Parameters:

pageSize - the size of the page to

Returns:

a Rectangle with the required dimensions and origin point

getDefaultProperty

public  T1 getDefaultProperty(int property)

Description copied from interface: IPropertyContainer

Gets the default property from this entity.

Specified by:

getDefaultProperty in interface IPropertyContainer

Overrides:

getDefaultProperty in class RootElement<Document>

Type Parameters:

T1 - the return type associated with the property

Parameters:

property - the property to be retrieved

Returns:

the default property value. If the default property is not defined, null will be returned

ensureRootRendererNotNull

protected RootRenderer ensureRootRendererNotNull()

Specified by:

ensureRootRendererNotNull in class RootElement<Document>

checkClosingStatus

protected void checkClosingStatus()

Checks whether a method is invoked at the closed document