| Paket | org.osmf.elements |
| Klasse | public class ProxyElement |
| Vererbung | ProxyElement  MediaElement EventDispatcher Object |
| Unterklassen | DurationElement, LoadFromDocumentElement |
| Sprachversion: | ActionScript 3.0 |
| Produktversion: | OSMF 1.0 |
| Laufzeitversionen: | Flash Player 10, AIR 1.5 |
Ein ProxyElement wird nicht direkt instantiiert, sondern als Basisklasse für die Erstellung von Wrappern für bestimmte Zwecke verwendet. Es können ProxyElement-Unterklassen für beliebige Merkmalstypen oder Gruppen von Merkmalstypen erstellt werden. Die Unterklasse steuert den Zugriff auf das über die Proxyklasse zugänglich gemachte Element entweder, indem ein oder mehrere Merkmale eines solchen Elements überschrieben oder indem sie blockiert werden.
Um Merkmale des über die Proxyklasse zugänglich gemachten Elements zu überschreiben, erstellt die Unterklasse eigene Merkmalsinstanzen. Diese werden von der Unterklasse dazu benutzt, die Merkmale zu ersetzen, die überschrieben werden sollen.
Um Merkmale zu blockieren, verhindert die Unterklasse, dass die Merkmale des über die Proxyklasse zugänglich gemachten Elements dargestellt werden, indem sie die blockedTraits-Eigenschaft des ProxyElement für die zu blockierenden Merkmalstypen festlegt. Dies veranlasst die hasTrait()-Methode des über die Proxyklasse zugänglich gemachten Elements, false zurückzugeben, und die getTrait()-Methode, null für die blockierten Merkmalstypen zurückzugeben.
Ein ProxyElement löst in der Regel die Ereignisse des über die Proxyklasse zugänglich gemachten Elements aus, es sei denn, der Merkmalstyp wurde vom ProxyElement geblockt.
ProxyElement-Unterklassen sind nützlich, um das Verhalten eines MediaElement auf nicht invasive Weise zu ändern. Beispiel: Das Hinzufügen ein Zeitsteuerungsfunktion zu einer Gruppe von ImageElements einer Diaschau, bei der die Bilder mit einer festgelegten Dauer angezeigt werden sollen. Die ProxyElement-Unterklasse würde als Proxy für die nicht zeitgesteuerten ImageElements fungieren und das TimeTrait des über die Proxyklasse zugänglich gemachten Elements überschreiben, um eine benutzerdefinierte Instanz dieses Merkmals zurückzugeben. Ein ähnlicher Ansatz kann auf andere Merkmale angewendet werden, entweder um eine alternative Implementierung einiger zugrunde liegender Merkmale des über die Proxyklasse zugänglich gemachten Elements bereitzustellen, oder um eine Implementierung zu ermöglichen, wenn ein erforderliches zugrunde liegendes Merkmal nicht vorhanden ist, oder um zu verhindern, dass ein zugrunde liegendes Merkmal überhaupt dargestellt wird.
Verwandte API-Elemente
Vererbte öffentliche Eigenschaften ausblenden
Vererbte öffentliche Eigenschaften anzeigen| Eigenschaft | Definiert von | ||
|---|---|---|---|
 | constructor : Object
Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz. | Object | |
| metadataNamespaceURLs : Vector.<String> [schreibgeschützt]
Ein Vektor, der die Namespace-URLs für alle in diesem Medienelement gespeicherten Metadatenobjekte enthält. | MediaElement | |
| Eigenschaft | Definiert von | ||
|---|---|---|---|
| Methode | Definiert von | ||
|---|---|---|---|
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registriert ein Ereignis-Listener-Objekt bei einem EventDispatcher-Objekt, sodass der Listener über ein Ereignis benachrichtigt wird. | EventDispatcher | |
|
Sendet ein Ereignis in den Ereignisablauf. | EventDispatcher | |
|
Überprüft, ob das EventDispatcher-Objekt Listener für einen bestimmten Ereignistyp registriert hat. | EventDispatcher | |
|
Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde. | Object | |
|
Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde. | Object | |
|
Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann. | Object | |
|
Entfernt einen Listener aus dem EventDispatcher-Objekt. | EventDispatcher | |
|
Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest. | Object | |
|
Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas. | Object | |
|
Gibt das angegebene Objekt als String zurück. | Object | |
|
Gibt den Grundwert des angegebenen Objekts zurück. | Object | |
|
Überprüft, ob bei diesem EventDispatcher-Objekt oder bei einem seiner Vorgänger ein Ereignis-Listener für einen bestimmten Ereignistyp registriert ist. | EventDispatcher | |
Tue Jun 12 2018, 10:04 AM Z