Guide de référence ActionScript® 3.0 pour la plate-forme Adobe® Flash®
Accueil  |  Masquer la liste des packages et des classes |  Packages  |  Classes  |  Nouveautés  |  Index  |  Annexes  |  Pourquoi existe-t-il du contenu en anglais ?
Filtres : Récupération des données du serveur...
Récupération des données du serveur...
org.osmf.elements 

ProxyElement  - AS3 OSMF

Packageorg.osmf.elements
Classepublic class ProxyElement
HéritageProxyElement Inheritance MediaElement Inheritance EventDispatcher Inheritance 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 est un élément multimédia qui agit comme enveloppe pour un autre MediaElement. Il vise à contrôler l’accès à l’élément enveloppé.

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



Propriétés publiques
 PropriétéDéfini par
 Inheritedconstructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet.
Object
 Inheritedcontainer : IMediaContainer
[lecture seule] Le conteneur multimédia que cet élément utilise.
MediaElement
 InheritedmetadataNamespaceURLs : Vector.<String>
[lecture seule] Vecteur contenant les URL d’espace de noms de tous les objets Metadata stockés dans ce MediaElement.
MediaElement
  proxiedElement : MediaElement
Le MediaElement pour lequel ce ProxyElement sert de proxy ou d’enveloppe.
ProxyElement
 Inheritedresource : MediaResourceBase
La ressource multimédia sur laquelle cet élément multimédia fonctionne.
MediaElement
 InheritedtraitTypes : Vector.<String>
[lecture seule] Un vecteur de valeurs MediaTraitType représentant les types de caractéristique sur cet élément multimédia.
MediaElement
Propriétés protégées
 PropriétéDéfini par
  blockedTraits : Vector.<String>
Le jeu de MediaTraitTypes que ce ProxyElement va bloquer.
ProxyElement
Méthodes publiques
 MéthodeDéfini par
  
ProxyElement(proxiedElement:MediaElement = null)
Constructeur.
ProxyElement
 Inherited
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
 Inherited
addMetadata(namespaceURL:String, metadata:Metadata):void
Ajoute un objet Metadata à ce MediaElement sous l’URL d’espace de noms spécifié.
MediaElement
 Inherited
Distribue un événement dans le flux d’événements.
EventDispatcher
 Inherited
Renvoie l’objet Metadata qui est stocké sous ce MediaElement avec l’URL d’espace de noms indiqué.
MediaElement
 Inherited
Renvoie le trait de support du type spécifié.
MediaElement
 Inherited
Vérifie si des écouteurs sont enregistrés auprès de l’objet EventDispatcher pour un type spécifique d’événement.
EventDispatcher
 Inherited
Indique si la propriété spécifiée d’un objet est définie.
Object
 Inherited
Détermine si cet élément média possède une caractéristique de média du type spécifié.
MediaElement
 Inherited
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
 Inherited
Indique si la propriété spécifiée existe et est énumérable.
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Supprime un écouteur de l’objet EventDispatcher.
EventDispatcher
 Inherited
Supprime l’objet Metadata stocké sous ce MediaElement avec l’URL d’espace de noms indiqué.
MediaElement
 Inherited
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle.
Object
 Inherited
Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur.
Object
 Inherited
Renvoie la représentation sous forme de chaîne de l’objet spécifié.
Object
 Inherited
Renvoie la valeur primitive de l’objet spécifié.
Object
 Inherited
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
Méthodes protégées
 MéthodeDéfini par
 Inherited
Ajoute une nouvelle caractéristique commune de média à cet élément multimédia.
MediaElement
 Inherited
Supprime une nouvelle caractéristique commune de média de cet élément multimédia.
MediaElement
 Inherited
Définit les traits de cet élément multimédia.
MediaElement
Evénements
 Evénement Synthèse Défini par
 Inherited[Evénement de diffusion] Distribué lorsque l’application Flash Player obtient le focus du système d’exploitation et devient active.EventDispatcher
 InheritedDistribué lorsque la propriété container de l’élément a été modifiée.MediaElement
 Inherited[Evénement de diffusion] Distribué lorsque l’application Flash Player ou AIR perd le focus du système d’exploitation et devient inactive.EventDispatcher
 InheritedDistribué lorsqu’une erreur entraînant une dégradation du fonctionnement de l’élément multimédia se produit.MediaElement
 InheritedDistribué lorsque des infos ayant un impact sur le fonctionnement de l’élément multimédia sont disponibles.MediaElement
 InheritedDistribué lorsqu’un objet Metadata a été ajouté à cet élément multimédia.MediaElement
 InheritedDistribué lorsqu’un objet Metadata a été supprimé de cet élément multimédia.MediaElement
 InheritedDistribué lorsqu’une caractéristique commune est ajoutée à l’élément multimédia.MediaElement
 InheritedDistribué lorsqu’une caractéristique commune est supprimée de l’élément multimédia.MediaElement
Détails de la propriété

blockedTraits

propriété
blockedTraits:Vector.<String>

Version du langage: ActionScript 3.0
Version du produit: OSMF 1.0
Versions du moteur d’exécution: Flash Player 10, AIR 1.5

Le jeu de MediaTraitTypes que ce ProxyElement va bloquer. Lorsqu’un trait est bloqué, le ProxyElement empêche ce trait d’être exposé lorsque l’élément traité par proxy contient le trait et pas le proxy. Les sous-classes peuvent l’appeler pour bloquer l’accès de façon sélective aux traits de l’élément traité par proxy sur une base par type.



Implémentation
    protected function get blockedTraits():Vector.<String>
    protected function set blockedTraits(value:Vector.<String>):void

proxiedElement

propriété 
proxiedElement:MediaElement

Version du langage: ActionScript 3.0
Version du produit: OSMF 1.0
Versions du moteur d’exécution: Flash Player 10, AIR 1.5

Le MediaElement pour lequel ce ProxyElement sert de proxy ou d’enveloppe.



Implémentation
    public function get proxiedElement():MediaElement
    public function set proxiedElement(value:MediaElement):void
Détails du constructeur

ProxyElement

()Constructeur
public function ProxyElement(proxiedElement:MediaElement = null)

Version du langage: ActionScript 3.0
Version du produit: OSMF 1.0
Versions du moteur d’exécution: Flash Player 10, AIR 1.5

Constructeur.

Paramètres
proxiedElement:MediaElement (default = null) — MediaElement à traiter par proxy. Les modifications apportées à l’élément traité par proxy sont répercutées dans les propriétés et événements de l’élément, à l’exception de ces modifications pour lesquelles un remplacement est prioritaire. Si le param est null, il doit être défini (via la méthode Set du proxiedElement) immédiatement après l’appel de ce constructeur et avant que toute autre méthode ne soit appelée sur ce ProxyElement, ou une exception IllegalOperationError est envoyée.




[ X ]Pourquoi existe-t-il du contenu en anglais ?
Certaines parties du Guide de référence ActionScript 3.0 sont en anglais

Tout le contenu du Guide de référence ActionScript 3.0 n’a pas été traduit dans toutes les langues. Si un élément de langage n’est pas traduit, il s’affiche en anglais. Par exemple, la classe ga.controls.HelpBox n’est traduite dans aucune langue. Ainsi, dans la version française du guide de référence, la classe ga.controls.HelpBox apparaît en anglais.