AmbientAttributes.clippingImage

[La característica asociada a esta página, Reproductor multimedia de Windows SDK, es una característica heredada. Se ha reemplazado por MediaPlayer. MediaPlayer se ha optimizado para Windows 10 y Windows 11. Microsoft recomienda encarecidamente que el nuevo código use MediaPlayer en lugar de Reproductor multimedia de Windows SDK, siempre que sea posible. Microsoft sugiere que el código existente que usa las API heredadas se reescriba para usar las nuevas API si es posible.

El atributo clippingImage especifica o recupera la región en la que se va a recortar el control.

        elementID.clippingImage

Valores posibles

Este atributo es una cadena de lectura y escritura que indica el nombre del archivo de imagen. No tiene valor predeterminado.

Observaciones

El atributo clippingImage admite archivos PNG, JPG, BMP y GIF (no incluidos los GIF animados). Dado que los JPG son pérdida y, por lo tanto, están sujetos a cambios de color inesperados, no se recomiendan para recortar imágenes.

Este atributo es útil cuando se desea mostrar solo una parte de la imagen de control y no todo el área rectangular. El atributo clippingColor indica las regiones de la imagen de recorte que corresponden a partes transparentes que no se pueden hacer clic en el control. Por lo tanto, el control puede ser de cualquier forma. Para obtener los mejores resultados, la imagen de recorte debe tener el mismo tamaño que la imagen de control.

El atributo clippingImage no es compatible con los elementos PLAYLIST, VIEW y SUBVIEW . Una imagen de recorte no funcionará con el elemento VIDEO si VIDEO. windowless se establece en false, ni con el elemento EFFECTS si EFFECTS. windowed se establece en true.

Dado que el uso de imágenes de recorte impone una penalización de rendimiento, no se deben usar cuando la eficiencia es un problema.

Ejemplos

Consulte el atributo BUTTONELEMENT.mappingColor para obtener un ejemplo que ilustra el uso de este atributo.

Requisitos

Requisito	Value
Versión	Reproductor multimedia de Windows versión 7.0 o posterior

Consulte también

Atributos de ambiente

AmbientAttributes.clippingColor