Package com.itextpdf.layout.element

Class Text

java.lang.Object

com.itextpdf.commons.actions.sequence.AbstractIdentifiableElement

com.itextpdf.layout.ElementPropertyContainer

com.itextpdf.layout.element.AbstractElement<Text>

com.itextpdf.layout.element.Text

All Implemented Interfaces:

IAbstractElement, IElement, ILeafElement, IPropertyContainer, IAccessibleElement

Direct Known Subclasses:

Link

       public class Text extends AbstractElement<Text> implements ILeafElement, IAccessibleElement
      

A Text is a piece of text of any length. As a leaf element, it is the smallest piece of content that may bear specific layout attributes.

Field Summary

Fields

Modifier and Type	Field	Description
protected DefaultAccessibilityProperties	tagProperties
protected String	text

Fields inherited from class com.itextpdf.layout.element.AbstractElement

childElements, nextRenderer, styles

Fields inherited from class com.itextpdf.layout.ElementPropertyContainer

properties

Constructor Summary

Constructors

Constructor	Description
Text(String text)	Constructs a Text with its role initialized.

Method Summary

Modifier and Type	Method	Description
AccessibilityProperties	getAccessibilityProperties()	Gets the accessibility properties.
Float	getHorizontalScaling()	Gets the horizontal scaling property, which determines how wide the text should be stretched.
String	getText()	Gets the contents of the Text object that will be rendered.
float	getTextRise()	Gets the text rise.
protected IRenderer	makeNewRenderer()	Creates new renderer instance.
Text	setHorizontalScaling(float horizontalScaling)	The horizontal scaling parameter adjusts the width of glyphs by stretching or compressing them in the horizontal direction.
Text	setNeutralRole()	Give this element a neutral role.
Text	setSkew(float alpha, float beta)	Skews the text to simulate italic and other effects.
void	setText(String text)	Sets the contents of the Text object.
Text	setTextRise(float textRise)	Sets the text rise.

Methods inherited from class com.itextpdf.layout.element.AbstractElement

addStyle, createRendererSubTree, getChildren, getProperty, getRenderer, hasProperty, isEmpty, setAction, setNextRenderer, setPageNumber

Methods inherited from class com.itextpdf.layout.ElementPropertyContainer

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

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.itextpdf.layout.element.IElement

createRendererSubTree, getRenderer, setNextRenderer

Methods inherited from interface com.itextpdf.layout.IPropertyContainer

deleteOwnProperty, getDefaultProperty, getOwnProperty, getProperty, hasOwnProperty, hasProperty, setProperty

Field Details

text

             protected String text
            

tagProperties

             protected DefaultAccessibilityProperties tagProperties
            

Constructor Details

Text

             public Text
             (String text)
            

Constructs a Text with its role initialized.

Parameters:

text - the contents, as a String

Method Details

getText

             public String getText()
            

Gets the contents of the Text object that will be rendered.

Returns:

the string with the contents

setText

             public void setText
             (String text)
            

Sets the contents of the Text object.

Parameters:

text - the new contents

getTextRise

             public float getTextRise()
            

Gets the text rise.

Returns:

the vertical distance from the text's default base line, as a float.

setTextRise

             public Text setTextRise
             (float textRise)
            

Sets the text rise.

Parameters:

textRise - a vertical distance from the text's default base line.

Returns:

this Text

getHorizontalScaling

             public Float getHorizontalScaling()
            

Gets the horizontal scaling property, which determines how wide the text should be stretched.

Returns:

the horizontal spacing, as a float

setSkew

             public Text setSkew
             (float alpha, float beta)
            

Skews the text to simulate italic and other effects. Try alpha=0 and beta=12.

Parameters:

alpha - the first angle in degrees

beta - the second angle in degrees

Returns:

this Text

setHorizontalScaling

             public Text setHorizontalScaling
             (float horizontalScaling)
            

The horizontal scaling parameter adjusts the width of glyphs by stretching or compressing them in the horizontal direction.

Parameters:

horizontalScaling - the scaling parameter. 1 means no scaling will be applied, 0.5 means the text will be scaled by half. 2 means the text will be twice as wide as normal one.

Returns:

this Text

getAccessibilityProperties

             public AccessibilityProperties getAccessibilityProperties()
            

Description copied from interface: IAccessibleElement

Gets the accessibility properties. See also IAccessibleElement.

Specified by:

getAccessibilityProperties in interface IAccessibleElement

Returns:

an interface that allows to specify properties of a tagged element in Tagged PDF.

setNeutralRole

             public Text setNeutralRole()
            

Give this element a neutral role. See also AccessibilityProperties.setRole(String).

Returns:

this Element

makeNewRenderer

             protected IRenderer makeNewRenderer()
            

Description copied from class: AbstractElement

Creates new renderer instance.

Specified by:

makeNewRenderer in class AbstractElement<Text>

Returns:

new IRenderer