| Package | org.osmf.elements |
| Classe | public class ProxyElement |
| Héritage | ProxyElement  MediaElement EventDispatcher Object |
| Sous-classes | DurationElement, LoadFromDocumentElement |
| Version du langage: | ActionScript 3.0 |
| Version du produit: | OSMF 1.0 |
| Versions du moteur d’exécution: | Flash Player 10, AIR 1.5 |
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
Masquer les propriétés publiques héritées
Afficher les propriétés publiques héritées| Propriété | Défini par | ||
|---|---|---|---|
 | constructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet. | Object | |
| metadataNamespaceURLs : Vector.<String> [lecture seule]
Vecteur contenant les URL d’espace de noms de tous les objets Metadata stockés dans ce MediaElement. | MediaElement | |
| Propriété | Défini par | ||
|---|---|---|---|
| Méthode | Défini par | ||
|---|---|---|---|
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Enregistre un objet écouteur d’événement auprès d’un objet EventDispatcher afin que l’écouteur soit averti d’un événement. | EventDispatcher | |
|
Distribue un événement dans le flux d’événements. | EventDispatcher | |
|
Vérifie si des écouteurs sont enregistrés auprès de l’objet EventDispatcher pour un type spécifique d’événement. | EventDispatcher | |
|
Indique si la propriété spécifiée d’un objet est définie. | Object | |
|
Indique si une occurrence de la classe Object figure dans la chaîne de prototype de l’objet spécifié en tant que paramètre. | Object | |
|
Indique si la propriété spécifiée existe et est énumérable. | Object | |
|
Supprime un écouteur de l’objet EventDispatcher. | EventDispatcher | |
|
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle. | Object | |
|
Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur. | Object | |
|
Renvoie la représentation sous forme de chaîne de l’objet spécifié. | Object | |
|
Renvoie la valeur primitive de l’objet spécifié. | Object | |
|
Vérifie si un écouteur d’événement est enregistré auprès de cet objet EventDispatcher ou de ses ancêtres pour le type d’événement spécifié. | EventDispatcher | |
Tue Jun 12 2018, 09:30 AM Z