M > MovieClip.setMask

MovieClip.setMask

Disponibilité

Flash Player 6.

Usage

monClip.setMask (clipDeMasque)

Paramètres

monClip Le nom d'occurrence d'un clip devant être masqué.

clipDeMasque Le nom d'occurrence d'un clip devant être un masque.

Renvoie

Rien.

Description

Méthode ; transforme le clip du paramètre clipDeMasque en masque révélant le clip spécifié par le paramètre monClip.

La méthode setMask permet à des clips multi-images, avec un contenu complexe multi-calques, d'agir en tant que masques. Vous pouvez activer et désactiver les masques à l'exécution. Cependant, vous ne pouvez pas utiliser le même masque pour masquer plusieurs objets (ce qui est possible en utilisant des calques de masque). Les polices de périphérique présentes dans un clip masqué sont tracées mais pas masquées. Vous ne pouvez pas définir un clip comme étant son propre masque, par exemple mc.setMask(mc).

Si vous créez un calque de masque qui contient un clip, puis que vous lui appliquez la méthode setMask, l'appel setMask est prioritaire et son effet est irréversible. Par exemple, vous pourriez avoir un clip dans un calque de masque appelé MasqueUI qui masque un autre calque contenant un autre clip appelé MasquéUI. Si, à la lecture de l'animation, vous appelez MasqueUI.setMask(MasquéUI), à partir de ce moment-là, MasqueUI est masqué par MasquéUI.

Pour annuler un masque créé avec ActionScript, transmettez la valeur null à la méthode setMask. Le code suivant annule le masque sans affecter le calque de masque dans le scénario.

MasqueUI.setMask(null)

Exemple

L'exemple de code suivant utilise le clip masqueCercle pour masquer le clip leMasqué.

leMasqué.setMask(masqueCercle);