home / documentation / reference / scrollbackgroundimage

ScrollBackgroundImage

Description:

Boolean value indicating whether or not the background image of a menu should scroll when the menu items scroll (true) or remain in place (false).

Value:

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

Applies To:

Menus.

Browser Compatibility:

ScrollBackgroundImage is not supported in Netscape 6.0x.

Comments:

ScrollBackgroundImage only has meaning on menus that have menu background images (MenuBackgroundImage) and are scrollable (ScrollEnabled). In all other menus ScrollBackgroundImage is ignored.

Note that the standard CSS background properties of scroll and fixed in the MenuBackgroundProperties parameter have no meaning in HierMenus menu background images. You must use ScrollBackgroundImage to assign your scrolling preference to the menu background image.

Examples:

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

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

Default:

false

See Also:

ScrollEnabled, MenuBackgroundImage, MenuBackgroundProperties, ItemBackgroundImage, ItemBackgroundProperties