User Guide

RectBorder class 647
RectBorder class
The RectBorder class is used as the border of most components. A separate implementation of
this class is provided by each theme, which has its own set of border styles and properties that it
supports.
You interact with the RectBorder class primarily by setting styles on other components. For
example, when you include a List component in a document and set the
borderStyle style
property, the List component creates a RectBorder instance that uses the list’s
borderStyle
setting. You may also create a custom RectBorder implementation to skin the border of all
components that use RectBorder.
The RectBorder class has four standard display styles:
none, inset, outset, and solid.
The Halo theme also adds four special display styles, which are used by specific components.
The RectBorder behavior and style properties described here are consistent for all components
that utilize the RectBorder class.
Using styles with the RectBorder class
You can set style properties to change the appearance of a RectBorder instance. A RectBorder
instance uses the following styles:
borderCapColor
borderColor
buttonColor
highlightColor
shadowCapColor
shadowColor
themeColor
The styles available on a particular RectBorder instance depend on the theme in use and the
border style set on the component. For an interactive demonstration that shows the relationship
between theme, border style, and available color style properties, see Using Components Help.
The four special Halo styles—
default, alert, dropDown, and menuBorder—have some lines
whose colors cannot be set through styles. You can only modify these colors by creating a custom
theme and modifying the appropriate ActionScript within the custom RectBorder
implementation.
Special style Component that uses it
default
Window
alert
Alert
dropDown
ComboBox and DateField
menuBorder
Menu and MenuBar
CHAPTER 6
Components Dictionary