Using styles with the List component

Halo

The base color scheme of a component. Possible values are "haloGreen", "haloBlue", and "haloOrange". The default value is "haloGreen".

Both

Specifies colors for rows in an alternating pattern. The value can be an array of two or more colors, for example, 0xFF00FF, 0xCC6699, and 0x996699. Unlike single-value color styles, alternatingRowColors does not accept color names; the values must be numeric color codes. By default, this style is not set and backgroundColor is used in its place for all rows.

Both

The background color of the list. The default color is white and is defined on the class style declaration. This style is ignored if alternatingRowColors is specified.

Both

The background color when the component's enabled property is set to "false". The default value is 0xDDDDDD (medium gray).

borderStyle

Both

The List component uses a RectBorder instance as its border and responds to the styles defined on that class. See RectBorder class.

The default border style is "inset".

Both

The text color.

Both

The color for text when the component is disabled. The default color is 0x848384 (dark gray).

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 is not used. If this style is set to true and fontFamily does not refer to an embedded font, no text is displayed. The default value is false.

Both

The font name for text. The default value is "_sans".

Both

The point size for the font. The default value is 10.

Both

The font style: either "normal" or "italic". The default value is "normal".

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() return "none".

Both

The text alignment: either "left", "right", or "center". The default value is "left".

Both

The text decoration: either "none" or "underline". The default value is "none".

Both

A number indicating the text indent. The default value is 0.

Both

The name of the default icon to display on each row. The default value is undefined, which means no icon is displayed.

Both

The number of milliseconds of delay between when a user first presses a button in the scrollbar and when the action begins to repeat. The default value is 500, half a second.

Both

The number of milliseconds between automatic clicks when a user holds the mouse button down on a button in the scrollbar. The default value is 35.

Both

The background color of a rolled-over row. The default value is 0xE3FFD6 (bright green) with the Halo theme and 0xAAAAAA (light gray) with the Sample theme.

When themeColor is changed through a setStyle() call, the framework sets rollOverColor to a value related to the themeColor chosen.

Both

The background color of a selected row. The default value is a 0xCDFFC1 (light green) with the Halo theme and 0xEEEEEE (very light gray) with the Sample theme.

When themeColor is changed through a setStyle() call, the framework sets selectionColor to a value related to the themeColor chosen.

Both

The length of the transition from a normal to selected state or back from selected to normal, in milliseconds. The default value is 200.

Both

The background color of a selected row. The default value is a 0xDDDDDD (medium gray). Because the default value for this property is the same as the default for backgroundDisabledColor, the selection is not visible when the component is disabled unless one of these style properties is changed.

Both

A reference to the easing equation used to control the transition between selection states. This applies only for the transition from a normal to a selected state. The default equation uses a sine in/out formula. For more information, see Customizing component animations in Using ActionScript 2.0 Components.

Both

The color of text when the pointer rolls over it. The default value is 0x2B333C (dark gray). This style is important when you set rollOverColor, because the two settings must complement each other so that text is easily viewable during a rollover.

Both

The color of text in the selected row. The default value is 0x005F33 (dark gray). This style is important when you set selectionColor, because the two settings must complement each other so that text is easily viewable while selected.

Both

Determines whether rolling over a row activates highlighting. The default value is true.