com.itextpdf.layout.renderer

Class TextRenderer

java.lang.Object

com.itextpdf.layout.renderer.AbstractRenderer

com.itextpdf.layout.renderer.TextRenderer

All Implemented Interfaces:

IPropertyContainer, IRenderer

Direct Known Subclasses:

LinkRenderer

public class TextRenderer
extends AbstractRenderer

This class represents the renderer object for a Text object. It will draw the glyphs of the textual content on the DrawContext.

Field Summary

Fields

Modifier and Type	Field and Description
protected com.itextpdf.io.font.otf.GlyphLine	line
protected boolean	otfFeaturesApplied
protected String	strToBeConverted
protected float	tabAnchorCharacterPosition
protected com.itextpdf.io.font.otf.GlyphLine	text
protected static float	TEXT_SPACE_COEFF
protected float	yLineOffset

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

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

Constructor Summary

Constructors

Modifier	Constructor and Description
	TextRenderer(Text textElement) Creates a TextRenderer from its corresponding layout object.
protected	TextRenderer(TextRenderer other)
	TextRenderer(Text textElement, String text) Creates a TextRenderer from its corresponding layout object, with a custom text to replace the contents of the Text.

Method Summary

Modifier and Type	Method and Description
void	applyOtf()
protected int	baseCharactersCount()
protected float	calculateLineWidth()
int	charAt(int pos) Gets char code at given position for the text belonging to this renderer.
protected TextRenderer	createOverflowRenderer()
protected TextRenderer	createSplitRenderer()
void	draw(DrawContext drawContext) Flushes the renderer subtree contents, i.e.
void	drawBackground(DrawContext drawContext) Draws a background layer if it is defined by a key Property.BACKGROUND in either the layout element or this IRenderer itself.
protected void	drawSingleUnderline(Underline underline, Color fontStrokeColor, PdfCanvas canvas, float fontSize, float italicAngleTan)
float	getAscent() Gets the maximum offset above the base line that this Text extends to.
<T1> T1	getDefaultProperty(int property) Gets the default property from this entity.
float	getDescent() Gets the maximum offset below the base line that this Text extends to.
protected Float	getFirstYLineRecursively() Gets the first yLine of the nested children recursively.
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.
protected int	getNumberOfSpaces()
float	getTabAnchorCharacterPosition()
com.itextpdf.io.font.otf.GlyphLine	getText()
float	getYLine() Gets the position on the canvas of the imaginary horizontal line upon which the Text's contents will be written.
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.
int	length() The length of the whole text assigned to this renderer.
protected int	lineLength() Returns the length of the line which is the result of the layout call.
void	moveYLineTo(float y) Moves the vertical position to the parameter's value.
void	setText(com.itextpdf.io.font.otf.GlyphLine text, int leftPos, int rightPos) Manually sets a GlyphLine to be rendered with a specific start and end point.
void	setText(String text) Manually sets the contents of the Text's representation on the canvas, regardless of the Text's own contents.
protected TextRenderer[]	split(int initialOverflowTextPos)
String	toString()
void	trimFirst() Trims any whitespace characters from the start of the GlyphLine to be rendered.
float	trimLast() Trims any whitespace characters from the end of the GlyphLine to be rendered.

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

addAllProperties, addChild, alignChildHorizontally, applyAbsolutePositioningTranslation, applyAction, applyBorderBox, applyDestination, applyMargins, applyPaddings, deleteOwnProperty, deleteProperty, drawBorder, drawChildren, getBorderAreaBBox, getBorders, getChildRenderers, getInnerAreaBBox, getModelElement, getOccupiedArea, getOccupiedAreaBBox, getOwnProperties, getOwnProperty, getProperty, getProperty, getPropertyAsBoolean, getPropertyAsColor, getPropertyAsFloat, getPropertyAsFont, getPropertyAsInteger, hasOwnProperty, hasProperty, initElementAreas, isFixedLayout, isFlushed, isNotFittingHeight, isPositioned, move, retrieveHeight, retrieveUnitValue, retrieveWidth, setBorders, setParent, setProperty

Methods inherited from class java.lang.Object

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

Field Detail

TEXT_SPACE_COEFF

protected static final float TEXT_SPACE_COEFF

See Also:

Constant Field Values

yLineOffset

protected float yLineOffset

text

protected com.itextpdf.io.font.otf.GlyphLine text

line

protected com.itextpdf.io.font.otf.GlyphLine line

strToBeConverted

protected String strToBeConverted

otfFeaturesApplied

protected boolean otfFeaturesApplied

tabAnchorCharacterPosition

protected float tabAnchorCharacterPosition

Constructor Detail

TextRenderer

public TextRenderer(Text textElement)

Creates a TextRenderer from its corresponding layout object.

Parameters:

textElement - the Text which this object should manage

TextRenderer

public TextRenderer(Text textElement,
                    String text)

Creates a TextRenderer from its corresponding layout object, with a custom text to replace the contents of the Text.

Parameters:

textElement - the Text which this object should manage

text - the replacement text

TextRenderer

protected TextRenderer(TextRenderer other)

Method Detail

layout

public LayoutResult layout(LayoutContext layoutContext)

Description copied from interface: IRenderer

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

applyOtf

public void applyOtf()

draw

public void draw(DrawContext drawContext)

Description copied from interface: IRenderer

Flushes the renderer subtree contents, i.e. draws itself on canvas, adds necessary objects to the PdfDocument etc.

Specified by:

draw in interface IRenderer

Overrides:

draw in class AbstractRenderer

Parameters:

drawContext - contains the PdfDocument to which the renderer subtree if flushed, the PdfCanvas on which the renderer subtree is drawn and other additional parameters needed to perform drawing

drawBackground

public void drawBackground(DrawContext drawContext)

Description copied from class: AbstractRenderer

Draws a background layer if it is defined by a key Property.BACKGROUND in either the layout element or this IRenderer itself.

Overrides:

drawBackground in class AbstractRenderer

Parameters:

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

getDefaultProperty

public <T1> 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 AbstractRenderer

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

trimFirst

public void trimFirst()

Trims any whitespace characters from the start of the GlyphLine to be rendered.

trimLast

public float trimLast()

Trims any whitespace characters from the end of the GlyphLine to be rendered.

Returns:

the amount of space in points which the text was trimmed by

getAscent

public float getAscent()

Gets the maximum offset above the base line that this Text extends to.

Returns:

the upwards vertical offset of this Text

getDescent

public float getDescent()

Gets the maximum offset below the base line that this Text extends to.

Returns:

the downwards vertical offset of this Text

getYLine

public float getYLine()

Gets the position on the canvas of the imaginary horizontal line upon which the Text's contents will be written.

Returns:

the y position of this text on the DrawContext

moveYLineTo

public void moveYLineTo(float y)

Moves the vertical position to the parameter's value.

Parameters:

y - the new vertical position of the Text

setText

public void setText(String text)

Manually sets the contents of the Text's representation on the canvas, regardless of the Text's own contents.

Parameters:

text - the replacement text

setText

public void setText(com.itextpdf.io.font.otf.GlyphLine text,
                    int leftPos,
                    int rightPos)

Manually sets a GlyphLine to be rendered with a specific start and end point.

Parameters:

text - a GlyphLine

leftPos - the leftmost end of the GlyphLine

rightPos - the rightmost end of the GlyphLine

getText

public com.itextpdf.io.font.otf.GlyphLine getText()

length

public int length()

The length of the whole text assigned to this renderer.

Returns:

the text length

toString

public String toString()

Overrides:

toString in class AbstractRenderer

charAt

public int charAt(int pos)

Gets char code at given position for the text belonging to this renderer.

Parameters:

pos - the position in range [0; length())

Returns:

Unicode char code

getTabAnchorCharacterPosition

public float getTabAnchorCharacterPosition()

getNextRenderer

public IRenderer getNextRenderer()

Description copied from interface: IRenderer

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

getFirstYLineRecursively

protected Float getFirstYLineRecursively()

Description copied from class: AbstractRenderer

Gets the first yLine of the nested children recursively. E.g. for a list, this will be the yLine of the first item (if the first item is indeed a paragraph). NOTE: this method will no go further than the first child. Returns null if there is no text found.

Overrides:

getFirstYLineRecursively in class AbstractRenderer

lineLength

protected int lineLength()

Returns the length of the line which is the result of the layout call.

baseCharactersCount

protected int baseCharactersCount()

getNumberOfSpaces

protected int getNumberOfSpaces()

createSplitRenderer

protected TextRenderer createSplitRenderer()

createOverflowRenderer

protected TextRenderer createOverflowRenderer()

split

protected TextRenderer[] split(int initialOverflowTextPos)

drawSingleUnderline

protected void drawSingleUnderline(Underline underline,
                                   Color fontStrokeColor,
                                   PdfCanvas canvas,
                                   float fontSize,
                                   float italicAngleTan)

calculateLineWidth

protected float calculateLineWidth()