User Guide

TextArea component 727
Using styles with the TextArea component
The TextArea component supports one set of component styles for all text in the field. However,
you can also display HTML that is compatible with Flash Player HTML rendering. To display
HTML text, set
TextArea.html to true.
The TextArea component has its
backgroundColor and borderStyle style properties defined on
a class style declaration. Class styles override global styles; therefore, if you want to set the
backgroundColor and borderStyle style properties, you must create a different custom style
declaration on the instance.
If the name of a style property ends in “Color”, it is a color style property and behaves differently
than noncolor style properties. For more information, see “Using styles to customize component
color and text” on page 67.
A TextArea component supports the following styles:
Style Theme Description
backgroundColor
Both The background color. The default color is white.
border styles
Both The TextArea component uses a RectBorder instance as its
border and responds to the styles defined on that class. See
“RectBorder class” on page 647.
The default border style is
"inset".
marginLeft
Both A number indicating the left margin for text. The default value
is 0.
marginRight
Both A number indicating the right margin for text. The default value
is 0.
color
Both The text color. The default value is 0x0B333C for the Halo
theme and blank for the Sample theme.
disabledColor
Both The color for text when the component is disabled. The default
color is 0x848384 (dark gray).
embedFonts
Both A Boolean value that indicates whether the font specified in
fontFamily is an embedded font. This style must be set to
true if fontFamily refers to an embedded font. Otherwise, the
embedded font will not be used. If this style is set to
true and
fontFamily does not refer to an embedded font, no text will be
displayed. The default value is
false.
fontFamily
Both The font name for text. The default value is "_sans".
fontSize
Both The point size for the font. The default value is 10.
fontStyle
Both The font style: either "normal" or "italic". The default value
is
"normal".
fontWeight
Both The font weight: either "none" or "bold". The default value
is
"none". All components can also accept the value "normal"
in place of "none" during a setStyle() call, but subsequent
calls to
getStyle() will return "none".