com.itextpdf.layout

Class Document

java.lang.Object

com.itextpdf.layout.ElementPropertyContainer<T>

com.itextpdf.layout.RootElement<Document>

com.itextpdf.layout.Document

All Implemented Interfaces:

IPropertyContainer

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
protected float	leftMargin
protected float	rightMargin
protected float	topMargin

Fields inherited from class com.itextpdf.layout.RootElement

childElements, defaultFont, defaultSplitCharacters, immediateFlush, pdfDocument, properties, rootRenderer

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.
<T extends IElement> Document	add(BlockElement<T> 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()
float	getLeftMargin()
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()
float	getTopMargin()
void	relayout() Performs an entire recalculation of the document flow, taking into account all its current child elements.
void	setBottomMargin(float bottomMargin)
void	setLeftMargin(float leftMargin)
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)
void	setTopMargin(float topMargin)

Methods inherited from class com.itextpdf.layout.RootElement

add, deleteOwnProperty, getDefaultProperty, getOwnProperty, getProperty, getRenderer, hasOwnProperty, hasProperty, setProperty, showTextAligned, showTextAligned, showTextAligned, showTextAligned, showTextAligned, showTextAligned, showTextAlignedKerned

Methods inherited from class com.itextpdf.layout.ElementPropertyContainer

getHeight, getSplitCharacters, getStrokeColor, getStrokeWidth, getTextRenderingMode, getWidth, setBackgroundColor, setBackgroundColor, setBaseDirection, setBold, setBorder, setBorderBottom, setBorderLeft, setBorderRight, setBorderTop, setCharacterSpacing, setDestination, setFixedPosition, setFixedPosition, setFixedPosition, setFixedPosition, setFont, setFontColor, setFontKerning, setFontScript, setFontSize, setHeight, setHorizontalAlignment, setHyphenation, setItalic, setLineThrough, setRelativePosition, setSplitCharacters, setStrokeColor, setStrokeWidth, setTextAlignment, setTextRenderingMode, setUnderline, setUnderline, setUnderline, setWidth, setWidth, setWidthPercent, setWordSpacing

Methods inherited from class java.lang.Object

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

Field Detail

leftMargin

protected float leftMargin

rightMargin

protected float rightMargin

topMargin

protected float topMargin

bottomMargin

protected float bottomMargin

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 <T extends IElement> Document add(BlockElement<T> 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 -

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.

ensureRootRendererNotNull

protected RootRenderer ensureRootRendererNotNull()

Specified by:

ensureRootRendererNotNull in class RootElement<Document>

getLeftMargin

public float getLeftMargin()

setLeftMargin

public void setLeftMargin(float leftMargin)

getRightMargin

public float getRightMargin()

setRightMargin

public void setRightMargin(float rightMargin)

getTopMargin

public float getTopMargin()

setTopMargin

public void setTopMargin(float topMargin)

getBottomMargin

public float getBottomMargin()

setBottomMargin

public void setBottomMargin(float bottomMargin)

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

checkClosingStatus

protected void checkClosingStatus()

checks whether a method is invoked at the closed document

Throws:

PdfException