com.cete.dynamicpdf.pageelements
Class HtmlTextArea

java.lang.Object
  |
  +--com.cete.dynamicpdf.PageElement
        |
        +--com.cete.dynamicpdf.pageelements.RotatingPageElement
              |
              +--com.cete.dynamicpdf.pageelements.HtmlTextArea

All Implemented Interfaces:

IArea, ICoordinate

Deprecated. As of DynamicPDF v4.0.0, Use the FormattedTextArea class instead.

public class HtmlTextArea

extends RotatingPageElement

implements IArea, ICoordinate

This class can be used to place HTML formatted text onto an area of the page.

The HtmlTextArea class accepts the following HTML tags and attributes. Some of the attributes are in addition to the attribute found in HTML and are used for advanced paragraph and line properties. Please note that white space can be treated literally or ignored (standard behavior for HTML).

These tags map directly into the HtmlTextAreaStyle class. This class is used internally to manage the state of the HTML Text Area. The style property of the HTML Text Area represents the initial state of the text.

<B ... - Bold Tag

Enclosed text is bold.

<Font ... - Font Tag

Attribute	Values	Description
Color	Web Color Hex String.	Color of the text.
Face	A string value.	The font family to use for the text. The 5 built-in font families ("Times" | "Helvetica" | "Courier" | "Symbol" | "ZapfDingbats") can be specified or additional ones can be added through the HtmlTextArea's FontFaces property.
Size	An integer value.	Specifies the HTML font size for the text. This is mapped to a point size internally (0 = 6 points, 1 = 8 points, 2 = 10 points, 3 = 12 points, 4 = 14 points, 5 = 18 points, 6 = 24 points, 7 = 36 points).
PointSize	A decimal value.	The size in points of the text.

<I ... - Italics Tag

Enclosed text is italic.

<Line ... - Line Tag

Attribute	Values	Description
Leading	A decimal value.	The leading of the line.
LeadingType	auto | atLeast | exactly	Specifies how leading is calculated.

<P ... - Paragraph Tag

Attribute	Values	Description
Align	left | right | center | justify	Alignment of the paragraph's text.
AllowOrphanLines	true | false	Specifies if one orphaned line should be allowed to be left on a page, or if it should be grouped with at least one other line for text continuation.
Indent	A decimal value.	The first line indentation of the paragraph in points.
LeftIndent	A decimal value.	The left indentation of the paragraph in points.
PreserveWhiteSpace	true | false	Specifies if white space should be preserved.
RightIndent	A decimal value.	The right indentation of the paragraph in points.
SpacingAfter	A decimal value.	The spacing after the paragraph in points.
SpacingBefore	A decimal value.	The spacing before the paragraph in points.

<U ... - Underline Tag

Enclosed text is underlined.

Licensing:
This class is a DynamicPDF Generator Professional Edition feature. One of the following licenses is required for non-evaluation usage:

• DynamicPDF Generator Professional Edition
• DynamicPDF Generator Enterprise Edition
• DynamicPDF Merger Professional Edition
• DynamicPDF Merger Enterprise Edition

View Example

See Also:

FormattedTextArea

Constructor Summary

HtmlTextArea(char[] text, float x, float y, float width, float height, FontFamily fontFamily, float fontSize, boolean preserveWhitespace)
Deprecated. As of DynamicPDF v4.0.0, Use the FormattedTextArea class instead.

HtmlTextArea(char[] text, float x, float y, float width, float height, HtmlTextAreaStyle style)
Deprecated. As of DynamicPDF v4.0.0, Use the FormattedTextArea class instead.

HtmlTextArea(java.lang.String text, float x, float y, float width, float height, FontFamily fontFamily, float fontSize, boolean preserveWhitespace)
Deprecated. As of DynamicPDF v4.0.0, Use the FormattedTextArea class instead.

HtmlTextArea(java.lang.String text, float x, float y, float width, float height, HtmlTextAreaStyle style)
Deprecated. As of DynamicPDF v4.0.0, Use the FormattedTextArea class instead.

Method Summary

protected void	drawRotated(PageWriter writer) Deprecated. As of DynamicPDF v4.0.0, Use the FormattedTextArea class instead.
FontFamilyList	getFontFaces() Deprecated. As of DynamicPDF v4.0.0, Use the FormattedTextArea class instead.
float	getHeight() Deprecated. As of DynamicPDF v4.0.0, Use the FormattedTextArea class instead.
HtmlTextArea	getOverflowHtmlTextArea() Deprecated. As of DynamicPDF v4.0.0, Use the FormattedTextArea class instead.
HtmlTextArea	getOverflowHtmlTextArea(float x, float y) Deprecated. As of DynamicPDF v4.0.0, Use the FormattedTextArea class instead.
HtmlTextArea	getOverflowHtmlTextArea(float x, float y, float height) Deprecated. As of DynamicPDF v4.0.0, Use the FormattedTextArea class instead.
float	getRequiredHeight() Deprecated. As of DynamicPDF v4.0.0, Use the FormattedTextArea class instead.
HtmlTextAreaStyle	getStyle() Deprecated. As of DynamicPDF v4.0.0, Use the FormattedTextAreaStyle class instead.
java.lang.String	getText() Deprecated. As of DynamicPDF v4.0.0, Use the FormattedTextArea class instead.
float	getWidth() Deprecated. As of DynamicPDF v4.0.0, Use the FormattedTextArea class instead.
boolean	hasOverflowText() Deprecated. As of DynamicPDF v4.0.0, Use the FormattedTextArea class instead.
void	setHeight(float value) Deprecated. As of DynamicPDF v4.0.0, Use the FormattedTextArea class instead.
void	setStyle(HtmlTextAreaStyle value) Deprecated. As of DynamicPDF v4.0.0, Use the FormattedTextAreaStyle class instead.
void	setText(java.lang.String value) Deprecated. As of DynamicPDF v4.0.0, Use the FormattedTextArea class instead.
void	setWidth(float value) Deprecated. As of DynamicPDF v4.0.0, Use the FormattedTextArea class instead.

Methods inherited from class com.cete.dynamicpdf.pageelements.RotatingPageElement

draw, getAngle, getX, getY, setAngle, setX, setY

Methods inherited from class com.cete.dynamicpdf.PageElement

getRequiredLicenseLevel, getStrID, setRequiredLicenseLevel, setStrID

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.cete.dynamicpdf.pageelements.ICoordinate

getX, getY, setX, setY

Constructor Detail

HtmlTextArea

public HtmlTextArea(java.lang.String text,
                    float x,
                    float y,
                    float width,
                    float height,
                    FontFamily fontFamily,
                    float fontSize,
                    boolean preserveWhitespace)

Deprecated. As of DynamicPDF v4.0.0, Use the FormattedTextArea class instead.

Initializes a new instance of the HtmlTextArea class.

Parameters:

text - Text to display in the HTML text area.

x - X coordinate of the HTML text area.

y - Y coordinate of the HTML text area.

width - Width of the HTML text area.

height - Height of the HTML text area.

fontFamily - Initial FontFamily of the HTML text area.

fontSize - Initial font size of the HTML text area.

preserveWhitespace - Specifies if white space should be preserved.

See Also:

FontFamily, FormattedTextArea

HtmlTextArea

public HtmlTextArea(java.lang.String text,
                    float x,
                    float y,
                    float width,
                    float height,
                    HtmlTextAreaStyle style)

Deprecated. As of DynamicPDF v4.0.0, Use the FormattedTextArea class instead.

Initializes a new instance of the HtmlTextArea class.

Parameters:

text - Text to display in the HTML text area.

x - X coordinate of the HTML text area.

y - Y coordinate of the HTML text area.

width - Width of the HTML text area.

height - Height of the HTML text area.

style - Initial HtmlTextAreaStyle of the HTML text area.

See Also:

HtmlTextAreaStyle, FormattedTextArea

HtmlTextArea

public HtmlTextArea(char[] text,
                    float x,
                    float y,
                    float width,
                    float height,
                    FontFamily fontFamily,
                    float fontSize,
                    boolean preserveWhitespace)

Deprecated. As of DynamicPDF v4.0.0, Use the FormattedTextArea class instead.

Initializes a new instance of the HtmlTextArea class.

Parameters:

text - Text to display in the HTML text area.

x - X coordinate of the HTML text area.

y - Y coordinate of the HTML text area.

width - Width of the HTML text area.

height - Height of the HTML text area.

fontFamily - Initial FontFamily of the HTML text area.

fontSize - Initial font size of the HTML text area.

preserveWhitespace - Specifies if white space should be preserved.

See Also:

FontFamily, FormattedTextArea

HtmlTextArea

public HtmlTextArea(char[] text,
                    float x,
                    float y,
                    float width,
                    float height,
                    HtmlTextAreaStyle style)

Deprecated. As of DynamicPDF v4.0.0, Use the FormattedTextArea class instead.

Initializes a new instance of the HtmlTextArea class.

Parameters:

text - Text to display in the HTML text area.

x - X coordinate of the HTML text area.

y - Y coordinate of the HTML text area.

width - Width of the HTML text area.

height - Height of the HTML text area.

style - Initial HtmlTextAreaStyle of the HTML text area.

See Also:

HtmlTextAreaStyle, FormattedTextArea

Method Detail

getFontFaces

public FontFamilyList getFontFaces()

Deprecated. As of DynamicPDF v4.0.0, Use the FormattedTextArea class instead.

Gets the List of FontFamily used by the HTML text area.

Returns:

FontFamilyList List of FontFamily used by the HTML text area.

See Also:

FontFamilyList, FormattedTextArea

getWidth

public float getWidth()

Deprecated. As of DynamicPDF v4.0.0, Use the FormattedTextArea class instead.

Gets the width of the HTML text area.

Specified by:

getWidth in interface IArea

Returns:

float The width of the HTML text area.

See Also:

FormattedTextArea

setWidth

public void setWidth(float value)

Deprecated. As of DynamicPDF v4.0.0, Use the FormattedTextArea class instead.

sets the width of the HTML text area.

Specified by:

setWidth in interface IArea

Throws:

GeneratorException - If width is changed on an overflow HtmlTextArea

Parameters:

value - The width of the HTML text area.

See Also:

FormattedTextArea

getHeight

public float getHeight()

Deprecated. As of DynamicPDF v4.0.0, Use the FormattedTextArea class instead.

Gets the height of the HTML text area.

Specified by:

getHeight in interface IArea

Overrides:

getHeight in class RotatingPageElement

Returns:

float Height of the HTML text area.

See Also:

FormattedTextArea

setHeight

public void setHeight(float value)

Deprecated. As of DynamicPDF v4.0.0, Use the FormattedTextArea class instead.

Sets the height of the HTML text area.

Specified by:

setHeight in interface IArea

Overrides:

setHeight in class RotatingPageElement

Parameters:

value - Height of the HTML text area.

See Also:

FormattedTextArea

getText

public java.lang.String getText()

Deprecated. As of DynamicPDF v4.0.0, Use the FormattedTextArea class instead.

Gets the text for the HTML text area.

Throws:

GeneratorException - If Text is read on an overflow HtmlTextArea.

Returns:

String Text for the HTML text area.

See Also:

FormattedTextArea

setText

public void setText(java.lang.String value)

Deprecated. As of DynamicPDF v4.0.0, Use the FormattedTextArea class instead.

Sets the text for the HTML text area.

Throws:

GeneratorException - If Text is changed on an overflow HtmlTextArea.

Parameters:

value - Text for the HTML text area.

See Also:

FormattedTextArea

getStyle

public HtmlTextAreaStyle getStyle()

Deprecated. As of DynamicPDF v4.0.0, Use the FormattedTextAreaStyle class instead.

Gets HtmlTextAreaStyle object used to specify the initial style of the HTML text area.

Returns:

HtmlTextAreaStyle Object used to specify the initial style of the HTML text area.

See Also:

HtmlTextAreaStyle, FormattedTextAreaStyle

setStyle

public void setStyle(HtmlTextAreaStyle value)

Deprecated. As of DynamicPDF v4.0.0, Use the FormattedTextAreaStyle class instead.

Sets HtmlTextAreaStyle object used to specify the initial style of the HTML text area.

Throws:

GeneratorException - If Style is changed on an overflow HtmlTextArea.

Parameters:

value - HtmlTextAreaStyle Object used to specify the initial style of the HTML text area.

See Also:

HtmlTextAreaStyle, FormattedTextAreaStyle

drawRotated

protected void drawRotated(PageWriter writer)

Deprecated. As of DynamicPDF v4.0.0, Use the FormattedTextArea class instead.

Draws the text area to the given PageWriter object.

Specified by:

drawRotated in class RotatingPageElement

Parameters:

writer - PageWriter object to receive the HTML text area's output.

See Also:

PageWriter, FormattedTextArea

getOverflowHtmlTextArea

public HtmlTextArea getOverflowHtmlTextArea()

Deprecated. As of DynamicPDF v4.0.0, Use the FormattedTextArea class instead.

Returns a new HtmlTextArea object containing the overflow text. View Example

Returns:

HtmlTextArea reference if there is overflow text. Otherwise null.

See Also:

FormattedTextArea

getOverflowHtmlTextArea

public HtmlTextArea getOverflowHtmlTextArea(float x,
                                            float y)

Deprecated. As of DynamicPDF v4.0.0, Use the FormattedTextArea class instead.

Returns a new HtmlTextArea object containing the overflow text. View Example

Parameters:

x - X coordinate of the new object.

y - Y coordinate of the new object.

Returns:

HtmlTextArea if there is overflow text. Otherwise null.

See Also:

FormattedTextArea

getOverflowHtmlTextArea

public HtmlTextArea getOverflowHtmlTextArea(float x,
                                            float y,
                                            float height)

Deprecated. As of DynamicPDF v4.0.0, Use the FormattedTextArea class instead.

Returns a new HtmlTextArea object containing the overflow text. View Example

Parameters:

x - X coordinate of the new object.

y - Y coordinate of the new object.

height - Height of the new object.

Returns:

HtmlTextArea if there is overflow text. Otherwise null.

See Also:

FormattedTextArea

getRequiredHeight

public float getRequiredHeight()

Deprecated. As of DynamicPDF v4.0.0, Use the FormattedTextArea class instead.

Returns the required height to fit all of the text of the HtmlTextArea.

Returns:

float Height required to fit all text.

See Also:

HtmlTextArea, FormattedTextArea

hasOverflowText

public boolean hasOverflowText()

Deprecated. As of DynamicPDF v4.0.0, Use the FormattedTextArea class instead.

Returns a value specifying if there is text that did not fit in the HtmlTextArea.

Returns:

true, if the HtmlTextArea has overflow text. Otherwise false.

See Also:

HtmlTextArea, FormattedTextArea