| 套件 | org.osmf.elements |
| 類別 | public class ProxyElement |
| 繼承 | ProxyElement  MediaElement EventDispatcher Object |
| 子類別 | DurationElement, LoadFromDocumentElement |
| 語言版本: | ActionScript 3.0 |
| 產品版本: | OSMF 1.0 |
| 執行階段版本: | 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.
相關 API 元素
隱藏繼承公用屬性
顯示繼承公用屬性| 屬性 | 定義自 | ||
|---|---|---|---|
 | constructor : Object
類別物件的參照或是特定物件實體的建構函數。 | Object | |
| container : IMediaContainer [唯讀]
The media container that this element uses. | MediaElement | |
| metadataNamespaceURLs : Vector.<String> [唯讀]
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> [唯讀]
A Vector of MediaTraitType values representing the trait types on this
media element. | MediaElement | |
| 屬性 | 定義自 | ||
|---|---|---|---|
| blockedTraits : Vector.<String>
The set of MediaTraitTypes that this ProxyElement will block. | ProxyElement | ||
| 方法 | 定義自 | ||
|---|---|---|---|
ProxyElement(proxiedElement:MediaElement = null)
Constructor. | ProxyElement | ||
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
會在 EventDispatcher 物件註冊事件偵聽程式，以便讓偵聽程式收到事件的通知。 | EventDispatcher | |
|
Adds a Metadata object to this MediaElement under the specified namespace URL. | MediaElement | |
|
會將事件傳送到事件流程。 | 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 | |
|
會檢查 EventDispatcher 物件是否有對特定的事件類型註冊偵聽程式。 | EventDispatcher | |
|
指出物件是否有已定義的指定屬性。 | Object | |
|
Determines whether this media element has a media trait of the
specified type. | MediaElement | |
|
指出 Object 類別的實體是否位於指定為參數的物件原型鏈中。 | Object | |
|
指出指定的屬性是否存在，以及是否可列舉。 | Object | |
|
會從 EventDispatcher 物件移除偵聽程式。 | EventDispatcher | |
|
Removes the Metadata object that was stored under this MediaElement with
the specified namespace URL. | MediaElement | |
|
為迴圈作業設定動態屬性的可用性。 | Object | |
|
傳回代表此物件的字串，根據地區特定慣例進行格式化。 | Object | |
|
會傳回指定之物件的字串形式。 | Object | |
|
會傳回指定之物件的基本值。 | Object | |
|
檢查此 EventDispatcher 物件是否已註冊事件偵聽程式，或者此物件的任何祖系已為特定事件類型註冊事件偵聽程式。 | EventDispatcher | |
blockedTraits | 屬性 |
blockedTraits:Vector.<String>| 語言版本: | ActionScript 3.0 |
| 產品版本: | OSMF 1.0 |
| 執行階段版本: | 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.
實作
protected function get blockedTraits():Vector.<String> protected function set blockedTraits(value:Vector.<String>):voidproxiedElement | 屬性 |
proxiedElement:MediaElement| 語言版本: | ActionScript 3.0 |
| 產品版本: | OSMF 1.0 |
| 執行階段版本: | Flash Player 10, AIR 1.5 |
The MediaElement for which this ProxyElement serves as a proxy, or wrapper.
實作
public function get proxiedElement():MediaElement public function set proxiedElement(value:MediaElement):voidProxyElement | () | 建構函式 |
public function ProxyElement(proxiedElement:MediaElement = null)| 語言版本: | ActionScript 3.0 |
| 產品版本: | OSMF 1.0 |
| 執行階段版本: | Flash Player 10, AIR 1.5 |
Constructor.
參數proxiedElement:MediaElement (default = null) |
Tue Jun 12 2018, 03:47 PM Z