Using styles with the ComboBox component

You can set style properties to change the appearance of a ComboBox component. 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 in Using ActionScript 2.0 Components.

The combo box has two unique styles: openDuration and openEasing. Other styles are passed to the button, text box, and drop-down list of the combo box through those individual components, as follows:

The button is a Button instance and uses its styles. (See Using styles with the Button component.)

The text is a TextInput instance and uses its styles. (See Using styles with the TextInput component.)

The drop-down list is an List instance and uses its styles. (See Using styles with the List component.)

A ComboBox component uses the following styles:

Style	Theme	Description
`themeColor`	Halo	The base color scheme of a component. Possible values are `"haloGreen"`, `"haloBlue"`, and `"haloOrange"`. The default value is `"haloGreen"`.
`backgroundColor`	Both	The background color. The default color is white.
`borderStyle`	Both	The Button subcomponent uses two RectBorder instances for its borders and responds to the styles defined on that class. See RectBorder class. In the Halo theme, the ComboBox component uses a custom rounded border for the collapsed portion of the ComboBox. The colors of this portion of the ComboBox can be modified only through skinning. See Using skins with the ComboBox component.
`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	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`.
`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()` return `"none"`.
`textAlign`	Both	The text alignment: either `"left"`, `"right"`, or `"center"`. The default value is `"left"`.
`textDecoration`	Both	The text decoration: either `"none"` or `"underline"`. The default value is `"none"`.
`openDuration`	Both	The duration, in milliseconds, of the transition animation. The default value is 250.
`openEasing`	Both	A reference to a tweening function that controls the animation. Defaults to sine in/out. For more information, see Customizing component animations in Using ActionScript 2.0 Components.

Style

Theme

Description

themeColor

Halo

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

backgroundColor

Both

The background color. The default color is white.

borderStyle

Both

The Button subcomponent uses two RectBorder instances for its borders and responds to the styles defined on that class. See RectBorder class.

In the Halo theme, the ComboBox component uses a custom rounded border for the collapsed portion of the ComboBox. The colors of this portion of the ComboBox can be modified only through skinning. See Using skins with the ComboBox component.

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

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.

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

textAlign

Both

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

textDecoration

Both

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

openDuration

Both

The duration, in milliseconds, of the transition animation. The default value is 250.

openEasing

Both

A reference to a tweening function that controls the animation. Defaults to sine in/out. For more information, see Customizing component animations in Using ActionScript 2.0 Components.

The following example demonstrates how to use List styles to control the behavior of the pop-up portion of a ComboBox component.

// comboBox is an instance of the ComboBox component on Stage.
comboBox.setStyle("alternatingRowColors", [0xFFFFFF, 0xBFBFBF]);