BUTTONGROUP.disabledImage

[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 disabledImage attribute specifies or retrieves the name of the image representing the disabled state of the buttons in the BUTTONGROUP.

        elementID.disabledImage

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.

When the disabled attribute of a BUTTONELEMENT element is set to true, the corresponding region of the disabledImage for the BUTTONGROUP is displayed. If the disabled image is larger than the defined region, the disabled image will be cropped.

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

Requirements

Requirement Value
Version
Windows Media Player version 7.0 or later

See also

BUTTONGROUP Element

BUTTONGROUP.hueShift

BUTTONGROUP.saturation