| 包 | 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 | |
| metadataNamespaceURLs : Vector.<String> [只读]
包含存储在此 MediaElement 内的所有 Metadata 对象的命名空间 URL 的矢量。 | MediaElement | |
受保护的属性
| 属性 | 由以下参数定义 | ||
|---|---|---|---|
公共方法
| 方法 | 由以下参数定义 | ||
|---|---|---|---|
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
使用 EventDispatcher 对象注册事件侦听器对象，以使侦听器能够接收事件通知。 | EventDispatcher | |
|
将事件调度到事件流中。 | EventDispatcher | |
|
检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。 | EventDispatcher | |
|
表示对象是否已经定义了指定的属性。 | Object | |
|
表示 Object 类的实例是否在指定为参数的对象的原型链中。 | Object | |
|
表示指定的属性是否存在、是否可枚举。 | Object | |
|
从 EventDispatcher 对象中删除侦听器。 | EventDispatcher | |
|
设置循环操作动态属性的可用性。 | Object | |
|
返回此对象的字符串表示形式，其格式设置遵守区域设置特定的约定。 | Object | |
|
返回指定对象的字符串表示形式。 | Object | |
|
返回指定对象的原始值。 | Object | |
|
检查是否用此 EventDispatcher 对象或其任何祖代为指定事件类型注册了事件侦听器。 | EventDispatcher | |
受保护的方法
Tue Jun 12 2018, 11:04 AM Z