home / documentation / reference / bgcolorselected

BGColorSelected

Description:

The background color assigned when an item is selected; that is, when its child menu is currently visible and its KeepHilite parameter is set to true.

Value:

String, "", or JavaScript expression that returns a string/"".

Applies To:

Menu Items.

Browser Compatibility:

BGColorSelected is not supported in Netscape 4. Not all browsers may recognize all possible CSS values. Additionally, be careful with "system specific" colors such as threedhighlight which may cause errors in browsers that don't support them.

Comments:

BGColorSelected should be applied as a string, which means the value you supply should always be in quotes. Allowed values for BGColorSelected are the same as those allowed in the standard CSS background-color property (see the W3C Specs) and in fact, the value you supply is transferred as is to the JavaScript backgroundColor property for each menu item.

For those browsers that support them, you may also use system specific colors such as threedhighlight or menu. Note, however, that not all platforms recognize such colors; and in fact some platforms will report errors when attempting to use them. Be sure to test system colors extensively before deploying them, and note that you may be able to exclude system colors for a specific browser or platform using conditional parameter assignments. See the DHTML Lab article Accessing the User-Defined System Colors, Part I for further information on system colors.

Examples:

// Ok:
BGColorSelected:"blue",
BGColorSelected:"#99CCFF",    // #rrggbb
BGColorSelected:"",           // use style sheet default
BGColorSelected:(HM_IE)?"menu":"red",
      // menu if IE, white otherwise

// Incorrect:
BGColorSelected:"greatgreen",  // must be valid color identifier
BGColorSelected:red,           // quotes required
BGColorSelected:"FFCC99",      // use leading pound (#) with rgb
BGColorSelected:'(HM_IE)?"menu":"red"', // no quoted expressions

Default:

"lightgrey"

See Also:

FontColor, FontColorOver, FontColorSelected, BGColor, BGColorOver, IsPermHilite, IsSelected, IsRollover, KeepHilite, Using Classes Mini-Tutorial