ProxyElement  - AS3 OSMF

Paket	org.osmf.elements
Klasse	public class ProxyElement
Vererbung	ProxyElement MediaElement EventDispatcher Object
Unterklassen	DurationElement, LoadFromDocumentElement

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