Windows Media Player 11 SDK BUTTONGROUP.mappingImageĀ
Previous | Next |
BUTTONGROUP.mappingImage
The mappingImage attribute specifies or retrieves the name of the image representing the button map of the BUTTONGROUP.
Syntax
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.
See the BUTTONELEMENT**.mappingColor** attribute for a code sample illustrating the use of this attribute.
Requirements
Windows Media Player version 7.0 or later.
See Also
Previous | Next |