org.apache.poi.hslf.model

Class TextRun

java.lang.Object

org.apache.poi.hslf.model.TextRun

public final class TextRun
extends Object

This class represents a run of text in a powerpoint document. That run could be text on a sheet, or text in a note. It is only a very basic class for now

Author:

Nick Burch

Field Summary

Fields

Modifier and Type	Field and Description
protected TextBytesAtom	_byteAtom
protected TextCharsAtom	_charAtom
protected TextHeaderAtom	_headerAtom
protected boolean	_isUnicode
protected Record[]	_records all text run records that follow TextHeaderAtom.
protected RichTextRun[]	_rtRuns
protected TextRulerAtom	_ruler
protected StyleTextPropAtom	_styleAtom

Constructor Summary

Constructors

Constructor and Description
TextRun(TextHeaderAtom tha, TextBytesAtom tba, StyleTextPropAtom sta) Constructs a Text Run from a Ascii text block
TextRun(TextHeaderAtom tha, TextCharsAtom tca, StyleTextPropAtom sta) Constructs a Text Run from a Unicode text block

Method Summary

Methods

Modifier and Type	Method and Description
RichTextRun	appendText(String s) Adds the supplied text onto the end of the TextRun, creating a new RichTextRun (returned) for it to sit in.
void	buildRichTextRuns(LinkedList<TextPropCollection> pStyles, LinkedList<TextPropCollection> cStyles, String runRawText)
void	changeTextInRichTextRun(RichTextRun run, String s) Handles an update to the text stored in one of the Rich Text Runs
TextRulerAtom	createTextRuler()
void	ensureStyleAtomPresent() Ensure a StyleTextPropAtom is present for this run, by adding if required.
Hyperlink[]	getHyperlinks() Returns the array of all hyperlinks in this text run
protected int	getIndex()
String	getRawText() Returns the raw text content of the run.
Record[]	getRecords() Returns records that make up this text run
RichTextRun	getRichTextRunAt(int pos) Fetch RichTextRun at a given position
RichTextRun[]	getRichTextRuns() Fetch the rich text runs (runs of text with the same styling) that are contained within this block of text
int	getRunType() Returns the type of the text, from the TextHeaderAtom.
protected int	getShapeId()
Sheet	getSheet()
StyleTextProp9Atom	getStyleTextProp9Atom() Numbered List info
StyleTextPropAtom	getStyleTextPropAtom() Characters covered
String	getText() Returns the text content of the run, which has been made safe for printing and other use.
TextRulerAtom	getTextRuler()
String	normalize(String s) Returns a new string with line breaks converted into internal ppt representation
protected void	setIndex(int id)
void	setRawText(String s) Changes the text, and sets it all to have the same styling as the the first character has.
void	setRunType(int type) Changes the type of the text.
protected void	setShapeId(int id)
void	setSheet(Sheet sheet)
void	setStyleTextProp9Atom(StyleTextProp9Atom styleTextProp9Atom) Numbered List info
void	setText(String s) Changes the text.
void	supplySlideShow(SlideShow ss) Supply the SlideShow we belong to.

Methods inherited from class java.lang.Object

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

Field Detail

_headerAtom

protected TextHeaderAtom _headerAtom

_byteAtom

protected TextBytesAtom _byteAtom

_charAtom

protected TextCharsAtom _charAtom

_styleAtom

protected StyleTextPropAtom _styleAtom

_ruler

protected TextRulerAtom _ruler

_isUnicode

protected boolean _isUnicode

_rtRuns

protected RichTextRun[] _rtRuns

_records

protected Record[] _records

all text run records that follow TextHeaderAtom. (there can be misc InteractiveInfo, TxInteractiveInfo and other records)

Constructor Detail

TextRun

public TextRun(TextHeaderAtom tha,
       TextCharsAtom tca,
       StyleTextPropAtom sta)

Constructs a Text Run from a Unicode text block

Parameters:

tha - the TextHeaderAtom that defines what's what

tca - the TextCharsAtom containing the text

sta - the StyleTextPropAtom which defines the character stylings

TextRun

public TextRun(TextHeaderAtom tha,
       TextBytesAtom tba,
       StyleTextPropAtom sta)

Constructs a Text Run from a Ascii text block

Parameters:

tha - the TextHeaderAtom that defines what's what

tba - the TextBytesAtom containing the text

sta - the StyleTextPropAtom which defines the character stylings

Method Detail

buildRichTextRuns

public void buildRichTextRuns(LinkedList<TextPropCollection> pStyles,
                     LinkedList<TextPropCollection> cStyles,
                     String runRawText)

appendText

public RichTextRun appendText(String s)

Adds the supplied text onto the end of the TextRun, creating a new RichTextRun (returned) for it to sit in. In many cases, before calling this, you'll want to add a newline onto the end of your last RichTextRun

changeTextInRichTextRun

public void changeTextInRichTextRun(RichTextRun run,
                           String s)

Handles an update to the text stored in one of the Rich Text Runs

Parameters:

run -

s -

setRawText

public void setRawText(String s)

Changes the text, and sets it all to have the same styling as the the first character has. If you care about styling, do setText on a RichTextRun instead

setText

public void setText(String s)

Changes the text. Converts '\r' into '\n'

ensureStyleAtomPresent

public void ensureStyleAtomPresent()

Ensure a StyleTextPropAtom is present for this run, by adding if required. Normally for internal TextRun use.

getText

public String getText()

Returns the text content of the run, which has been made safe for printing and other use.

getRawText

public String getRawText()

Returns the raw text content of the run. This hasn't had any changes applied to it, and so is probably unlikely to print out nicely.

getRichTextRuns

public RichTextRun[] getRichTextRuns()

Fetch the rich text runs (runs of text with the same styling) that are contained within this block of text

getRunType

public int getRunType()

Returns the type of the text, from the TextHeaderAtom. Possible values can be seen from TextHeaderAtom

See Also:

TextHeaderAtom

setRunType

public void setRunType(int type)

Changes the type of the text. Values should be taken from TextHeaderAtom. No checking is done to ensure you set this to a valid value!

See Also:

TextHeaderAtom

supplySlideShow

public void supplySlideShow(SlideShow ss)

Supply the SlideShow we belong to. Also passes it on to our child RichTextRuns

setSheet

public void setSheet(Sheet sheet)

getSheet

public Sheet getSheet()

getShapeId

protected int getShapeId()

Returns:

Shape ID

setShapeId

protected void setShapeId(int id)

Parameters:

id - Shape ID

getIndex

protected int getIndex()

Returns:

0-based index of the text run in the SLWT container

setIndex

protected void setIndex(int id)

Parameters:

id - 0-based index of the text run in the SLWT container

getHyperlinks

public Hyperlink[] getHyperlinks()

Returns the array of all hyperlinks in this text run

Returns:

the array of all hyperlinks in this text run or null if not found.

getRichTextRunAt

public RichTextRun getRichTextRunAt(int pos)

Fetch RichTextRun at a given position

Parameters:

pos - 0-based index in the text

Returns:

RichTextRun or null if not found

getTextRuler

public TextRulerAtom getTextRuler()

createTextRuler

public TextRulerAtom createTextRuler()

normalize

public String normalize(String s)

Returns a new string with line breaks converted into internal ppt representation

getRecords

public Record[] getRecords()

Returns records that make up this text run

Returns:

text run records

setStyleTextProp9Atom

public void setStyleTextProp9Atom(StyleTextProp9Atom styleTextProp9Atom)

Numbered List info

getStyleTextProp9Atom

public StyleTextProp9Atom getStyleTextProp9Atom()

Numbered List info

getStyleTextPropAtom

public StyleTextPropAtom getStyleTextPropAtom()

Characters covered