BUTTON.image

[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 image attribute specifies or retrieves the default image of the BUTTON.

        elementID.image

Possible Values

This attribute is a read/write String containing the image file name.

Remarks

The supported image formats are BMP, JPG, PNG, and GIF (including animated GIFs).

If the BUTTON image is larger than the region defined by the width and height attributes, the image will be cropped.

If the image is not specified but the height and width are, then the image directly behind this control is displayed. This can facilitate drawing the image on the VIEW itself, reducing the number of separate image files needed.

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

Requirements

See also

BUTTON Element