com.adobe.xfa.text

Class TextRegion

java.lang.Object

com.adobe.xfa.text.TextLegacy

com.adobe.xfa.text.TextStream

com.adobe.xfa.text.TextSparseStream

com.adobe.xfa.text.TextDispStr

com.adobe.xfa.text.TextRegion

public class TextRegion
extends TextDispStr

A text region is a displayable stream (see class TextDispStr) that has both minimum and maximum height and width. The region's graphical footprint will occupy at least its minimum height and width. Text content may caus it to grow to its maximums, but never larger. If the text exceeds the space available, scrolling may be required or displayed content may be truncated. The application may change the minimum and maximum dimensions through method calls, causing the region to be redisplayed if a text display has already been created.

Field Summary

Fields inherited from class com.adobe.xfa.text.TextStream

DEFAULT_STREAM

Fields inherited from class com.adobe.xfa.text.TextLegacy

LEVEL_CORRECT_SPACING, LEVEL_NORMAL, LEVEL_V6

Constructor Summary

Constructors

Constructor and Description
TextRegion() Default constructor.
TextRegion(String sSource) Constructor with source text string.

Method Summary

Modifier and Type	Method and Description
void	copyFrom(TextRegion oSource) Assign this text region's content from the given text region.
boolean	enforceSize() Query whether the stream enforces text region size at data entry time.
void	enforceSize(boolean bNewEnforce) Change the value of the EnforceSize flag.
boolean	equals(Object object) Compare text regions for equality.
UnitSpan	getMaxHeight() Return the maximum height of the text region.
UnitSpan	getMaxWidth() Return the maximum width of the text region.
UnitSpan	getMinHeight() Return the minimum height of the text region.
UnitSpan	getMinWidth() Return the minimum width of the text region.
int	hashCode()
boolean	notEqual(TextRegion oCompare) Compare text streams for inequality.
void	setJustifyExtents(UnitSpan oJustifyWidth, UnitSpan oJustifyHeight) Set the justfiy extents of the text region.
void	setJustifyHeight(UnitSpan oJustifyHeight) Set the justfiy height of the text region.
void	setJustifyWidth(UnitSpan oJustifyWidth) Set the justfiy width of the text region.
void	setMaxHeight(UnitSpan oNewHeight) Set the maximum height of the text region.
void	setMaxWidth(UnitSpan oNewWidth) Set the maximum width of the text region.
void	setMinHeight(UnitSpan oNewHeight) Set the minimum height of the text region.
void	setMinWidth(UnitSpan oNewWidth) Set the minimum width of the text region.

Methods inherited from class com.adobe.xfa.text.TextDispStr

allowOverflow, allowOverflow, combCells, combCells, enforceJustifyHeight, enforceJustifyWidth, extent, justifyHeight, justifyHPoint, justifyVPoint, justifyWidth, maxHeight, maxWidth, minHeight, minWidth, notEqual, onLoadFrame, runtimeExtent, unlimitedHeight, unlimitedWidth

Methods inherited from class com.adobe.xfa.text.TextSparseStream

appendFrame, appendFrame, appendFrameRef, appendFrameRef, createDisplay, defaultDirection, defaultDirection, forceFrame, forceFrame, getContext, getFrame, getFrameCount, insertFrame, insertFrameRef, onFrameRemoved, onNewFrame, onRemoveFrame, removeFrame, removeFrame, setContext, setFrame, setFrameCount, setFrameRef

Methods inherited from class com.adobe.xfa.text.TextStream

allowNewLines, allowNewLines, anyNewLines, append, append, append, append, append, append, cascadeLegacyLevel, coalesceMarker, contiguousText, copyFrom, currentSize, debug, display, enumEmbed, enumField, enumMarker, find, find, findRangeMarkerOver, fontService, fontService, gfxSource, gfxSource, isDescendentOf, isDescendentOf, legacyPositioning, markup, markup, markup, markup, markup, maxSize, maxSize, notEqual, position, posnCount, posnInsert, posnInsert, posnInsertPara, posnNext, posnNextAttr, posnNextChar, posnNextEmbed, posnNextField, posnNextType, posnNextType, posnPrev, posnPrevAttr, posnPrevChar, posnPrevEmbed, posnPrevField, posnPrevType, posnPrevType, posnUpdateStreamLoc, rangeEnumMarker, rangeMarker, rangeMarkerInternal, removeMarker, setText, spaceLeft, splitMarker, suppressFormat, text, text, updateNotification

Methods inherited from class com.adobe.xfa.text.TextLegacy

getLegacyLevel, hasCorrectPositioning, hasLegacyPositioning, hasNormalPositioning, setLegacyLevel

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

TextRegion

public TextRegion()

Default constructor.

The text stream contains no content and has no pool/mapping assocotiation. The minimum and maximum width and height are all defaulted to one inch.

TextRegion

public TextRegion(String sSource)

Constructor with source text string.

Create a text stream whose initial content is copied from the given string. The minimum and maximum width and height are all defaulted to one inch. The text stream initially has no attribute pool association. The display is not automatically created.

Parameters:

sSource - - String whose contents are to be copied to the text stream.

Method Detail

getMinWidth

public UnitSpan getMinWidth()

Return the minimum width of the text region.

This provides the same information as the virtual MinWidth() method in the base class, TextDispStr.

Returns:

Minimum width of the text region. For information on special values, please see the base class (TextDispStr) documentation.

setMinWidth

public void setMinWidth(UnitSpan oNewWidth)

Set the minimum width of the text region.

This method allows the caller to change the minimum width of the text region, possibly triggering a redisplay.

Parameters:

oNewWidth - - New minimum width of the text region. For information on special values, please see the base class (TextDispStr) documentation.

getMinHeight

public UnitSpan getMinHeight()

Return the minimum height of the text region.

This provides the same information as the virtual Minheight() method in the base class, TextDispStr.

Returns:

Minimum height of the text region. For information on special values, please see the base class (TextDispStr) documentation.

setMinHeight

public void setMinHeight(UnitSpan oNewHeight)

Set the minimum height of the text region.

This method allows the caller to change the minimum height of the text region, possibly triggering a redisplay.

Parameters:

oNewHeight - - New minimum height of the text region. For information on special values, please see the base class (TextDispStr) documentation.

getMaxWidth

public UnitSpan getMaxWidth()

Return the maximum width of the text region.

This provides the same information as the virtual MaxWidth() method in the base class, TextDispStr.

Returns:

Maximum width of the text region. For information on special values, please see the base class (TextDispStr) documentation.

setMaxWidth

public void setMaxWidth(UnitSpan oNewWidth)

Set the maximum width of the text region.

This method allows the caller to change the maximum width of the text region, possibly triggering a redisplay.

Parameters:

oNewWidth - - New maximum width of the text region. For information on special values, please see the base class (TextDispStr) documentation.

getMaxHeight

public UnitSpan getMaxHeight()

Return the maximum height of the text region.

This provides the same information as the virtual Maxheight() method in the base class, TextDispStr.

Returns:

Maximum height of the text region. For information on special values, please see the base class (TextDispStr) documentation.

setMaxHeight

public void setMaxHeight(UnitSpan oNewHeight)

Set the maximum height of the text region.

This method allows the caller to change the maximum height of the text region, possibly triggering a redisplay.

Parameters:

oNewHeight - - New maximum height of the text region. For information on special values, please see the base class (TextDispStr) documentation.

setJustifyHeight

public void setJustifyHeight(UnitSpan oJustifyHeight)

Set the justfiy height of the text region.

This method sets the height to use during justification calculations

setJustifyWidth

public void setJustifyWidth(UnitSpan oJustifyWidth)

Set the justfiy width of the text region.

This method sets the height to use during justification calculations

setJustifyExtents

public void setJustifyExtents(UnitSpan oJustifyWidth,
                              UnitSpan oJustifyHeight)

Set the justfiy extents of the text region.

This method sets the height to use during justification calculations

enforceSize

public boolean enforceSize()

Query whether the stream enforces text region size at data entry time.

Returns:

TRUE if the graphical size is being enforced; FALSE if not. Note that the constructor defaults this to TRUE.

enforceSize

public void enforceSize(boolean bNewEnforce)

Change the value of the EnforceSize flag.

Parameters:

bNewEnforce - - TRUE causes the text region to respect its maximum size; FALSE allows the text content to exceed the maximum size of the region. Note that the constructor defaults this to TRUE.

copyFrom

public void copyFrom(TextRegion oSource)

Assign this text region's content from the given text region.

Replace this stream's content with a copy of the content of the given stream. The graphic source information is not copied. In other words, fonts will be re-mapped in this stream's font service and attributes will be re-pooled in any attribute pool associated with this stream. The minimum and maximum width and height of the source stream are also copied. The display pointer is not copied, as each stream has its own display; nor is a display automatically created.

Parameters:

oSource - - Stream containing source content to copy.

equals

public boolean equals(Object object)

Compare text regions for equality.

Compare this stream against the one passed on the parameter oCompare for equality. The graphics sources of the streams are not compared. To be equal, the streams' content must match in all aspects: raw text, attributes, embedded field content, and so on. The display does not participate in the comparison. In addition, the text regions' minimum and maximum width and height must match.

Overrides:

equals in class TextDispStr

Parameters:

object - - Stream to compare against

Returns:

TRUE if the streams are equal; FALSE otherwise.

hashCode

public int hashCode()

Overrides:

hashCode in class TextDispStr

notEqual

public boolean notEqual(TextRegion oCompare)

Compare text streams for inequality.

Compare this stream against the one passed on the parameter oCompare for inequality. The graphics sources of the streams are not compared. This is the exact opposite of the equality comparison. The display does not participate in the comparison.

Parameters:

oCompare - - Stream to compare against

Returns:

TRUE if the streams are unequal; FALSE otherwise.