ProxyElement  - AS3 OSMF

Package	org.osmf.elements
Classe	public class ProxyElement
Héritage	ProxyElement MediaElement EventDispatcher Object
Sous-classes	DurationElement, LoadFromDocumentElement

ProxyElement n’est pas instancié directement mais utilisé comme classe de base pour créer des enveloppes à des fins spécifiques. ProxyElement peut être sous-classé pour n’importe quel type de trait ou ensemble de types de trait. La sous-classe surveille l’accès à l’élément traité par proxy soit en remplaçant au moins l’un des traits de l’élément traité par proxy soit en le bloquant.

Pour remplacer l’un des traits de l’élément traité par proxy, la sous-classe crée ses propres instances de trait qu’elle substitue aux traits de l’élément traité par proxy qu’elle souhaite remplacer.

Pour bloquer des traits, la sous-classe empêche les traits de l’élément traité par proxy d’être exposés en définissant la propriété blockedTraits du ProxyElement pour les types de trait qu’elle souhaite bloquer. Ainsi, la méthode hasTrait() de l’élément traité par proxy renvoie la valeur false et sa méthode getTrait() renvoie null pour les types de trait bloqués.

Un ProxyElement distribue normalement les événements de l’élément traité par proxy, à moins que le type du trait figure parmi ceux qui sont bloqués par le ProxyElement.

Les sous-classes ProxyElement sont utiles pour modifier le comportement d’un MediaElement de manière non invasive. Un exemple serait d’ajouter des capacités temporelles à un ensemble d’ImageElements pour les présenter sous forme de diaporama dans lequel les images sont affichées pour une durée spécifiée. La sous-classe ProxyElement traiterait par proxy les ImageElements non temporels et remplacerait le TimeTrait de l’élément traité par proxy pour renvoyer une instance personnalisée de ce trait. La même approche peut être appliquée à d’autres traits, soit pour fournir un autre type d’implémentation de certains des traits sous-jacents de l’élément traité par proxy, soit pour fournir une implémentation lorsqu’un trait sous-jacent nécessaire n’existe pas ou pour empêcher un trait sous-jacent d’être exposé.

Eléments de l’API associés