AmbientAttributes.clippingImage

L’attribut clippingImage spécifie ou récupère la zone dans laquelle détourer le contrôle.

        elementID.clippingImage

Valeurs possibles

Cet attribut est une chaîne en lecture/écriture indiquant le nom du fichier image. Il n'a aucune valeur par défaut.

Notes

L’attribut clippingImage prend en charge les fichiers PNG, jpg, BMP et GIF (à l’exclusion des fichiers GIF animés). Étant donné que les JPGs sont perdus et, par conséquent, soumis à une modification de couleur inattendue, ils ne sont pas recommandés pour les images de découpage.

Cet attribut est utile lorsque vous souhaitez afficher uniquement une partie de l’image de contrôle, et non l’intégralité de la zone rectangulaire. L’attribut clippingColor indique les régions de l’image de découpage qui correspondent à des portions transparentes et non intercliquables du contrôle. Le contrôle peut donc être de n’importe quelle forme. Pour de meilleurs résultats, l’image de découpage doit être de la même taille que l’image de contrôle.

L’attribut clippingImage n’est pas pris en charge par les éléments playlist, View et subview . Une image de découpage ne fonctionne pas avec l’élément vidéo si la vidéo est. sans fenêtre est défini sur false, ni avec l’élément Effects si Effects. Windowed a la valeur true.

Étant donné que l’utilisation d’images de découpage impose une baisse des performances, elles ne doivent pas être utilisées lorsque l’efficacité est un problème.

Exemples

Consultez l’attribut BUTTONELEMENT. mappingColor pour obtenir un exemple illustrant l’utilisation de cet attribut.

Spécifications

Condition requise Valeur
Version
Lecteur Windows Media version 7,0 ou ultérieure

Voir aussi

Attributs ambiants

AmbientAttributes.clippingColor