Using styles with the Menu component

You can call the setStyle() method to change the style of the menu, its items, and its submenus.The Menu component supports the following styles:

Style

n

Description

themeColor

Halo

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

alternatingRowColors

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.

backgroundColor

Both

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

backgroundDisabledColor

Both

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

borderStyle

Both

The Menu 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 "menuBorder".

color

Both

The text color.

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 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".

textIndent

Both

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

defaultIcon

Both

The name of the default icon to display on each row. The default value is undefined, which means no icon is displayed. The icon property is not required, does not work for "check", "radio", or "separator" items, and uses the linkage identifier of an image asset as the value parameter. All menu items show the same icon.

popupDuration

Both

The duration of the transition as a menu opens. The value is specified in milliseconds; 0 indicates no transition. The default value is 150.

rollOverColor

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.

selectionColor

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.

selectionDuration

Both

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

selectionEasing

Both

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

textRollOverColor

Both

The color of text when the pointer rolls over. 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 rollover.

textSelectedColor

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 must complement each other so that text is easily viewable while selected.

useRollOver

Both

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