AmbientAttributes.clippingImage

  • Article

[La fonctionnalité associée à cette page, Lecteur multimédia Windows SDK, est une fonctionnalité héritée. Il a été remplacé par MediaPlayer. MediaPlayer a été optimisé pour Windows 10 et Windows 11. Microsoft recommande vivement que le nouveau code utilise MediaPlayer au lieu de Lecteur multimédia Windows SDK, lorsque cela est possible. Microsoft suggère que le code existant qui utilise les API héritées soit réécrit pour utiliser les nouvelles API si possible.]

L’attribut clippingImage spécifie ou récupère la région dans laquelle découper 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 (sans les GIF animés). Étant donné que les JPG sont en perte et sont donc sujets à des changements de couleur inattendus, 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 la zone rectangulaire entière. L’attribut clippingColor indique les régions de l’image de découpage qui correspondent à des parties transparentes et non cliquables du contrôle. Le contrôle peut donc être de n’importe quelle forme. Pour obtenir de meilleurs résultats, l’image de découpage doit avoir 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 fonctionnera pas avec l’élément VIDEO si VIDEO. windowless 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 pénalité de 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.

Configuration requise

Condition requise Valeur
Version
 Lecteur multimédia Windows version 7.0 ou ultérieure

Voir aussi

Attributs ambiants

AmbientAttributes.clippingColor