Windows Media Player SDK banner art
PreviousNext

BUTTONGROUP.mappingImage

The mappingImage attribute specifies or retrieves the name of the image representing the button map of the BUTTONGROUP.

Syntax

elementID.mappingImage

Possible Values

This attribute is a read/write String.

Remarks

This is a mandatory attribute that must be specified. 

The mapping image should be the same dimensions as the main image. It is a map of the clickable areas of the main image. Construct the map by filling each clickable area with a different color.

When defining each BUTTONELEMENT, designate its color from the map using the mappingColor attribute. For example, if you have a stop-sign-shaped button graphic in the main image, you can create a map with the area of the sign colored red. The BUTTONELEMENT attribute must then be specified as red to make the stop-sign image clickable.

The supported image formats are BMP, JPG, PNG, and GIF (not including animated GIFs). Because JPGs are lossy and therefore subject to unexpected color change, they are not recommended for mapping images.

Example

The following is an example of a mappingImage and the visible image it corresponds to. These images are part of the skin in the Tiny folder included with the SDK.

sample mapping image sample background image

Please see the BUTTONELEMENT.mappingColor attribute for a code sample illustrating the use of this attribute.

See Also

PreviousNext


© 2000-2001 Microsoft Corporation. All rights reserved.