| 包 | 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 不直接进行实例化，而是用作基类，以创建适用于特定目的的包装器。ProxyElement 可以是任何特征类型或特征类型集的子类。子类通过覆盖一个或多个代理元素的特征或阻止它们来控制对代理元素的访问。
为覆盖任何代理元素的特征，子类会创建自己的特征实例，用其来替代希望覆盖的代理元素的特征。
为阻止特征，子类通过设置它要阻止的特征类型的 ProxyElement 的 blockedTraits 属性来阻止公开代理元素的特征。这会导致代理元素的 hasTrait() 方法返回 false，其 getTrait() 方法为阻止的特征类型返回 null。
ProxyElement 通常调度代理元素的事件，除非特征类型属于 ProxyElement 阻止的那些类型。
ProxyElement 子类对于以非入侵方式修改 MediaElement 的行为很有用。示例会将临时功能添加到一组 ImageElement 中，从而在幻灯片放映中显示这些 ImageElement，在放映过程中，将在指定的持续时间内显示图像。ProxyElement 子类将代理非临时的 ImageElement，并覆盖代理元素的 TimeTrait 以返回该特征的自定义实例。类似方法可以应用于其它特征，用于提供某些代理元素的基础特征的替代实现，在需要的基础特征不存在时提供实现，或完全阻止公开基础特征。
相关 API 元素
隐藏继承的公共属性
显示继承的公共属性| 属性 | 由以下参数定义 | ||
|---|---|---|---|
 | constructor : Object
对类对象或给定对象实例的构造函数的引用。 | Object | |
| container : IMediaContainer [只读]
此元素使用的媒体容器。 | MediaElement | |
| metadataNamespaceURLs : Vector.<String> [只读]
包含存储在此 MediaElement 内的所有 Metadata 对象的命名空间 URL 的矢量。 | MediaElement | |
| proxiedElement : MediaElement
此 ProxyElement 作为其代理或包装器的 MediaElement。 | ProxyElement | ||
| resource : MediaResourceBase
此媒体元素对其执行操作的媒体资源。 | MediaElement | |
| traitTypes : Vector.<String> [只读]
MediaTraitType 值的矢量，表示此媒体元素的特征类型。 | MediaElement | |
| 属性 | 由以下参数定义 | ||
|---|---|---|---|
| blockedTraits : Vector.<String>
此 ProxyElement 将阻止的一组 MediaTraitType。 | ProxyElement | ||
| 方法 | 由以下参数定义 | ||
|---|---|---|---|
ProxyElement(proxiedElement:MediaElement = null)
构造函数。 | ProxyElement | ||
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
使用 EventDispatcher 对象注册事件侦听器对象，以使侦听器能够接收事件通知。 | EventDispatcher | |
|
将 Metadata 对象添加到指定命名空间 URL 下的此 MediaElement 中。 | MediaElement | |
|
将事件调度到事件流中。 | EventDispatcher | |
|
返回存储在此 MediaElement 下具有指定命名空间 URL 的 Metadata 对象。 | MediaElement | |
|
返回指定类型的媒体特征。 | MediaElement | |
|
检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。 | EventDispatcher | |
|
表示对象是否已经定义了指定的属性。 | Object | |
|
确定此媒体元素是否包含指定类型的媒体特征。 | MediaElement | |
|
表示 Object 类的实例是否在指定为参数的对象的原型链中。 | Object | |
|
表示指定的属性是否存在、是否可枚举。 | Object | |
|
从 EventDispatcher 对象中删除侦听器。 | EventDispatcher | |
|
删除存储在此 MediaElement 下具有指定命名空间 URL 的 Metadata 对象。 | MediaElement | |
|
设置循环操作动态属性的可用性。 | Object | |
|
返回此对象的字符串表示形式，其格式设置遵守区域设置特定的约定。 | Object | |
|
返回指定对象的字符串表示形式。 | Object | |
|
返回指定对象的原始值。 | Object | |
|
检查是否用此 EventDispatcher 对象或其任何祖代为指定事件类型注册了事件侦听器。 | EventDispatcher | |
blockedTraits | 属性 |
blockedTraits:Vector.<String>| 语言版本: | ActionScript 3.0 |
| 产品版本: | OSMF 1.0 |
| 运行时版本: | Flash Player 10, AIR 1.5 |
此 ProxyElement 将阻止的一组 MediaTraitType。在阻止某个特征后，如果代理元素包含此特征而代理不包含该特征，则 ProxyElement 会阻止公开该特征。子类可以调用此，从而根据每个类型有选择地阻止对代理元素的特征的访问。
实现
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 |
此 ProxyElement 作为其代理或包装器的 MediaElement。
实现
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 |
构造函数。
参数proxiedElement:MediaElement (default = null) |
Tue Jun 12 2018, 11:04 AM Z