BUTTONGROUP.hoverImage

[The feature associated with this page, Windows Media Player SDK, is a legacy feature. It has been superseded by MediaPlayer. MediaPlayer has been optimized for Windows 10 and Windows 11. Microsoft strongly recommends that new code use MediaPlayer instead of Windows Media Player SDK, when possible. Microsoft suggests that existing code that uses the legacy APIs be rewritten to use the new APIs if possible.]

The hoverImage attribute specifies or retrieves the name of the image representing the hover state of a button in the BUTTONGROUP. The hover state occurs when the button is in the up state and the user hovers over it with the mouse.

        elementID.hoverImage

Possible Values

This attribute is a read/write String.

Remarks

The supported image formats are BMP, JPG, PNG, and GIF. If the image is an 8-bit BMP file, its hue and saturation values can be changed dynamically using the hueShift and saturation attributes.

The default image is the one specified in the image attribute, or its default.

If the hover image is larger than the defined region, the hover image will be cropped.

If the image cannot be retrieved, a default image (the red-x image) is displayed.

Examples

See the BUTTONELEMENT.mappingColor attribute for a sample illustrating the use of this attribute.

Requirements

Requirement	Value
Version	Windows Media Player version 7.0 or later

See also

BUTTONGROUP Element

BUTTONGROUP.hueShift

BUTTONGROUP.image

BUTTONGROUP.saturation