Pakiet | org.osmf.elements |
Klasa | public class ProxyElement |
Dziedziczenie | ProxyElement MediaElement EventDispatcher Object |
Podklasy | DurationElement, LoadFromDocumentElement |
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | OSMF 1.0 |
Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
ProxyElement is not instantiated directly but rather used as the base class for creating wrappers for specific purposes. ProxyElement can be subclassed for any trait type or set of trait types. The subclass controls access to the proxied element either by overriding one or more of the proxied element's traits or by blocking them.
To override any of the proxied element's traits, the subclass creates its own trait instances, which it substitutes for the proxied element's traits that it wishes to override.
To block traits, the subclass prevents the traits of
the proxied element from being exposed by setting the ProxyElement's
blockedTraits
property for the trait
types that it wants to block.
This causes the proxied element's hasTrait()
method to return false
and its
getTrait()
method to return null
for the blocked trait types.
A ProxyElement normally dispatches the proxied element's events, unless the trait's type is among those that are blocked by the ProxyElement.
ProxyElement subclasses are useful for modifying the behavior of a MediaElement in a non-invasive way. An example would be adding temporal capabilities to a set of ImageElements to present them in a slide show in which the images are displayed for a specified duration. The ProxyElement subclass would proxy the non-temporal ImageElements and override the proxied element's TimeTrait to return a custom instance of that trait. A similar approach can be applied to other traits, either to provide an alternate implementation of some of the proxied element's underlying traits, to provide an implementation when a needed underlying trait does not exist, or to prevent an underlying trait from being exposed at all.
Powiązane elementy interfejsu API
Właściwość | Zdefiniowane przez | ||
---|---|---|---|
constructor : Object
Odwołanie do obiektu klasy lub funkcji konstruktora, dotyczące danej instancji obiektu. | Object | ||
container : IMediaContainer [tylko do odczytu]
The media container that this element uses. | MediaElement | ||
metadataNamespaceURLs : Vector.<String> [tylko do odczytu]
A Vector containing the namespace URLs for all Metadata
objects stored within this MediaElement. | MediaElement | ||
proxiedElement : MediaElement
The MediaElement for which this ProxyElement serves as a proxy,
or wrapper. | ProxyElement | ||
resource : MediaResourceBase
The media resource that this media element operates on. | MediaElement | ||
traitTypes : Vector.<String> [tylko do odczytu]
A Vector of MediaTraitType values representing the trait types on this
media element. | MediaElement |
Właściwość | Zdefiniowane przez | ||
---|---|---|---|
blockedTraits : Vector.<String>
The set of MediaTraitTypes that this ProxyElement will block. | ProxyElement |
Metoda | Zdefiniowane przez | ||
---|---|---|---|
ProxyElement(proxiedElement:MediaElement = null)
Constructor. | ProxyElement | ||
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Rejestruje obiekt detektora zdarzeń w obiekcie EventDispatcher, dzięki czemu detektor będzie otrzymywał powiadomienia o zdarzeniu. | EventDispatcher | ||
Adds a Metadata object to this MediaElement under the specified namespace URL. | MediaElement | ||
Wywołuje zdarzenie, tj. kieruje je do przepływu zdarzeń. | EventDispatcher | ||
Returns the Metadata object that is stored under this MediaElement with
the specified namespace URL. | MediaElement | ||
Returns the media trait of the specified type. | MediaElement | ||
Sprawdza, czy obiekt EventDispatcher zawiera jakiekolwiek detektory zarejestrowane dla konkretnego typu zdarzeń. | EventDispatcher | ||
Wskazuje, czy dla obiektu zdefiniowano określoną właściwość. | Object | ||
Determines whether this media element has a media trait of the
specified type. | MediaElement | ||
Wskazuje, czy instancja klasy Object należy do łańcucha prototypów obiektu określonego jako parametr. | Object | ||
Wskazuje, czy określona właściwość istnieje i jest przeliczalna. | Object | ||
Usuwa detektor z obiektu EventDispatcher. | EventDispatcher | ||
Removes the Metadata object that was stored under this MediaElement with
the specified namespace URL. | MediaElement | ||
Ustawia dostępność właściwości dynamicznej używanej w pętlach. | Object | ||
Zwraca ciąg reprezentujący obiekt — sformatowany zgodnie z konwencjami właściwymi dla ustawień regionalnych. | Object | ||
Zwraca ciąg reprezentujący określony obiekt. | Object | ||
Zwraca pierwotną wartość dla określonego obiektu. | Object | ||
Sprawdza, czy detektor zdarzeń określonego typu jest zarejestrowany w tym obiekcie EventDispatcher lub jego elementach macierzystych. | EventDispatcher |
blockedTraits | właściwość |
blockedTraits:Vector.<String>
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | OSMF 1.0 |
Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
The set of MediaTraitTypes that this ProxyElement will block. When a trait is blocked, the ProxyElement will prevent that trait from being exposed when the proxied element contains the trait and the proxy does not. Subclasses can call this to selectively block access to the traits of the proxied element on a per-type basis.
Implementacja
protected function get blockedTraits():Vector.<String>
protected function set blockedTraits(value:Vector.<String>):void
proxiedElement | właściwość |
proxiedElement:MediaElement
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | OSMF 1.0 |
Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
The MediaElement for which this ProxyElement serves as a proxy, or wrapper.
Implementacja
public function get proxiedElement():MediaElement
public function set proxiedElement(value:MediaElement):void
ProxyElement | () | Konstruktor |
public function ProxyElement(proxiedElement:MediaElement = null)
Wersja języka: | ActionScript 3.0 |
Wersja produktu: | OSMF 1.0 |
Wersje środowiska wykonawczego: | Flash Player 10, AIR 1.5 |
Constructor.
ParametryproxiedElement:MediaElement (default = null ) — MediaElement to proxy. Changes to the proxied
element are reflected in the proxy element's properties and events,
with the exception of those changes for which an override takes
precedence. If the param is null, then it must be set (via the
proxiedElement setter) immediately after this constructor call, and
before any other methods on this ProxyElement are called, or an
IllegalOperationError will be thrown.
|
Tue Jun 12 2018, 12:06 PM Z