home / documentation / reference / imagewidth

ImageWidth

Description:

The width of the more image, in pixels.

Value:

Integer, or JavaScript expression that returns an integer. Negative integers are not allowed.

Applies To:

Menu Items.

Browser Compatibility:

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

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.

You must always specify ImageWidth as a number, or a JavaScript expression that returns a number. Do not use quoted strings or non-numerical characters when defining ImageWidth. ImageWidth is always interpreted by HM in pixels.

In previous versions of HierMenus (prior to version 6), ImageWidth was known is ImageSize.

It is recommended that both the ImageWidth and ImageHeight parameters be set to the actual, natural height and width of the images you are using. Scaling images by setting their ImageWidth and/or ImageHeight parameters to a value other than the natural size of the image itself is not recommended. You will have generally better performance if you create or size your images specifically to the dimension you require in a graphics program and then use those scaled images, instead.

Examples:

// Ok:
ImageWidth:7,
ImageWidth:10,
ImageWidth:(HM_Mac)?8:6, // 8 in Mac, 6 all others

// Incorrect:
ImageWidth:"7",
ImageWidth:10px,
ImageWidth:"(HM_Mac)?8:6", // Do not quote expressions here

Default:

5

See Also:

ImageHeight, ImageHorizSpace, ImageVertSpace