home / documentation / reference / isselected

IsSelected

Description:

Boolean value indicating whether or not a menu item should be permanently selected; that is, always displayed as if it has a child menu that is currently visible.

Value:

Boolean (true or false), Integer (1=true, 0=false), or JavaScript expression that returns a boolean value.

Applies To:

Menu Items.

Browser Compatibility:

IsSelected is not supported in Netscape 4.x.

Comments:

IsSelected can be used as a shortcut way to create menu item labels; i.e., instead of specifying an exact color scheme for the menu item in question, you can instead simply set IsSelected to true. The menu item will then always appear as it would if it had a visible child menu (i.e., in its "selected" state). Rolling the mouse over IsSelected items will have no effect on the item's display.

If an item is marked both IsPermHilite and IsSelected, IsPermHilite will take precedence.

Examples:

// Ok:
IsSelected:true,
IsSelected:0,
IsSelected:(window.thisPage=="cf")?1:0, 
    // if the user defined variable "thisPage" is "cf", 
    // IsSelected is true

// Incorrect:
IsSelected:"false",  // quotes not allowed around booleans
IsSelected:"0",
IsSelected:'(window.thisPage=="cf")?1:0', // no quoted expressions

Default:

false

See Also:

IsRollover, KeepHilite, IsSelected