home / documentation / reference / imagesrcover

ImageSrcOver

Description:

The src, i.e., server location, of the graphic to be used for the more image when the mouse is hovering over the menu item. Also assigned to the more image of parent items if their child menus are visible and the item's KeepHilite parameter is set to true.

Value:

String, null, or JavaScript expression that returns a String/null.

Applies To:

Menu Items.

Browser Compatibility:

ImageSrcOver is supported in all browsers.

Comments:

"More" images are the (usually) triangular images that appear within a menu item denoting the existence of a child menu for this menu item. ImageSrcOver is the server location (URL) of the graphic that will be used for this more image when the mouse hovers over the item, or in parent items when their child menus are visible and their KeepHilite parameters are set to true. By setting ImageSrcOver to a different graphic than ImageSrc, a rollover effect is created with the more image.

HierMenus provides several triangular graphics in its distribution file that are suitable for use in menus, however designers are welcome to create their own more images as appropriate. The graphics provided by HierMenus are located in the images sub-directory of the distribution file, and bear names such as HM_More_black_right.gif, HM_More_white_left.gif, etc.

Note how the configuration parameter setting ImageDir interacts with ImageSrcOver. If ImageSrcOver does not begin with http, then ImageDir is added to the front of ImageSrcOver to arrive at the actual server location for the image.

If ImageSrcOver is null and ImageDir is null, or if ImageSrcOver is the same as ImageSrc, no rollover effect is provided for the more image.

ImageSrcOver is used as the more rollover graphic for standard menus. When right-to-left menu displays are in effect (when RightToLeft is true), HierMenus uses ImageSrcLeftOver as the rollover image graphic.

Examples:

// Ok:
ImageSrcOver:"HM_More_black_right.gif",
ImageSrcOver:"http://myserver.com/myHMImages/HM_More_black_right.gif",
ImageSrcOver:null,
ImageSrcOver:(window.showMore)?"HM_More_green_left.gif":null,
    // if the user defined variable "showMore" is true,
    // then use "HM_More_green_left.gif

// Incorrect:
ImageSrcOver:HM_More_blue_right.gif,  // Strings must be quoted
ImageSrcOver:"null",                   // null must NOT be quoted
ImageSrcOver:'(window.showMore)?"HM_More_green_left.gif":null', 
    // no quoted expressions

Default:

"HM_More_white_right.gif"

See Also:

ImageDir, PreloadImages, IsPermHilite, IsSelected, IsRollover, KeepHilite, MoreImagesVisible, MoreImageAlt, ImageSrc, ImageSrcLeft, ImageSrcLeftOver, ImageWidth, ImageHeight, ImageHorizSpace, ImagevertSpace