Windows Media Player SDK banner art
PreviousNext

AmbientAttributes.clippingImage

The clippingImage attribute specifies or retrieves the region to clip the control to.

Syntax

elementID.clippingImage

Possible Values

This attribute is a read/write String indicating the image file name. It has no default value.

Remarks

The clippingImage attribute supports PNG, JPG, BMP, and GIF files (not including animated GIFs). This attribute is useful when you want to display only a part of the control image and not the entire rectangular area. The clippingColor attribute indicates the regions of the clipping image that correspond to transparent, non-clickable portions of the control. The control can therefore be of any shape. For best results, the clipping image should be the same size as the control image.

The clippingImage attribute is not supported by the PLAYLIST, VIEW, and SUBVIEW elements. A clipping image will not work with the VIDEO element if VIDEO.windowless is set to false, nor with the EFFECTS element if EFFECTS.windowed is set to true.

Example

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

See Also

PreviousNext


© 2000-2001 Microsoft Corporation. All rights reserved.