CompositeElement

包	org.osmf.elements
类	public class CompositeElement
继承	CompositeElement MediaElement EventDispatcher Object
子类	ParallelElement, SerialElement

语言版本:

ActionScript 3.0

产品版本:

OSMF 1.0

运行时版本:

Flash Player 10, AIR 1.5

CompositeElement 是一个媒体元素，可封装其它更精细的媒体元素的集合。它通常被称为媒体组合。

组成媒体组合的媒体元素被视为单个统一的媒体元素。例如，如果媒体组合封装一个视频序列，则 CompositeElement 的行为将与单个 VideoElement 的行为类似，但后者按顺序播放多个视频。

由于 CompositeElement 维护 MediaElement 子级的列表（该列表中的任何一项都可能是 CompositeElement 本身），因此媒体组合可表示为树结构。

通常不直接实例化 CompositeElement，而将其用作创建特定类型的媒体组合的基类。

公共属性

隐藏继承的公共属性

显示继承的公共属性

	属性		由以下参数定义
		constructor : Object 对类对象或给定对象实例的构造函数的引用。	Object
		container : IMediaContainer [只读] 此元素使用的媒体容器。	MediaElement
		metadataNamespaceURLs : Vector.<String> [只读] 包含存储在此 MediaElement 内的所有 Metadata 对象的命名空间 URL 的矢量。	MediaElement
		numChildren : int [只读] 此媒体组合中子级 MediaElement 的数目。	CompositeElement
		resource : MediaResourceBase 此媒体元素对其执行操作的媒体资源。	MediaElement
		traitTypes : Vector.<String> [只读] MediaTraitType 值的矢量，表示此媒体元素的特征类型。	MediaElement

公共方法

隐藏继承的公共方法

显示继承的公共方法

	方法		由以下参数定义
		CompositeElement() 构造函数。	CompositeElement
		addChild(child:MediaElement):MediaElement 将指定的子级添加到列表的末尾。	CompositeElement
		addChildAt(child:MediaElement, index:Number):MediaElement 将子级添加到列表的指定索引处。	CompositeElement
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void 使用 EventDispatcher 对象注册事件侦听器对象，以使侦听器能够接收事件通知。	EventDispatcher
		addMetadata(namespaceURL:String, metadata:Metadata):void 将 Metadata 对象添加到指定命名空间 URL 下的此 MediaElement 中。	MediaElement
		dispatchEvent(event:Event):Boolean 将事件调度到事件流中。	EventDispatcher
		getChildAt(index:int):MediaElement 获取指定索引处的子级。	CompositeElement
		getChildIndex(child:MediaElement):int 如果子级位于列表中（这样的话 getChildAt(index) == child），则返回该子级的索引。	CompositeElement
		getMetadata(namespaceURL:String):Metadata 返回存储在此 MediaElement 下具有指定命名空间 URL 的 Metadata 对象。	MediaElement
		getTrait(type:String):org.osmf.traits:MediaTraitBase 返回指定类型的媒体特征。	MediaElement
		hasEventListener(type:String):Boolean 检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。	EventDispatcher
		hasOwnProperty(name:String):Boolean 表示对象是否已经定义了指定的属性。	Object
		hasTrait(type:String):Boolean 确定此媒体元素是否包含指定类型的媒体特征。	MediaElement
		isPrototypeOf(theClass:Object):Boolean 表示 Object 类的实例是否在指定为参数的对象的原型链中。	Object
		propertyIsEnumerable(name:String):Boolean 表示指定的属性是否存在、是否可枚举。	Object
		removeChild(child:MediaElement):MediaElement 删除指定的子级并返回该子级。	CompositeElement
		removeChildAt(index:int):MediaElement 删除指定索引处的子级并返回该子级。	CompositeElement
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void 从 EventDispatcher 对象中删除侦听器。	EventDispatcher
		removeMetadata(namespaceURL:String):Metadata 删除存储在此 MediaElement 下具有指定命名空间 URL 的 Metadata 对象。	MediaElement
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 设置循环操作动态属性的可用性。	Object
		toLocaleString():String 返回此对象的字符串表示形式，其格式设置遵守区域设置特定的约定。	Object
		toString():String 返回指定对象的字符串表示形式。	Object
		valueOf():Object 返回指定对象的原始值。	Object
		willTrigger(type:String):Boolean 检查是否用此 EventDispatcher 对象或其任何祖代为指定事件类型注册了事件侦听器。	EventDispatcher

受保护的方法

隐藏继承的受保护方法

显示继承的受保护方法

	方法		由以下参数定义
		addTrait(type:String, instance:org.osmf.traits:MediaTraitBase):void 将新的媒体特征添加到此媒体元素。	MediaElement
		removeTrait(type:String):org.osmf.traits:MediaTraitBase 从此媒体元素中删除媒体特征。	MediaElement
		setupTraits():void 设置此媒体元素的特征。	MediaElement

事件

单击此处了解有关事件的更多信息

隐藏继承的事件

显示继承的事件

	摘要	由以下参数定义
activate	[广播事件] Flash Player 或 AIR 应用程序获得操作系统焦点并变为活动状态时将调度此事件。	EventDispatcher
containerChange	在元素的容器属性发生变化时调度。	MediaElement
deactivate	[广播事件] Flash Player 或 AIR 应用程序失去操作系统焦点并变为非活动状态时将调度此事件。	EventDispatcher
mediaError	在发生影响媒体元素的操作的错误时调度。	MediaElement
mediaInfo	当影响媒体元素操作的信息可用时调度。	MediaElement
metadataAdd	在将 Metadata 对象添加到此媒体元素时调度。	MediaElement
metadataRemove	在从此媒体元素中删除 Metadata 对象时调度。	MediaElement
traitAdd	在将某一特征添加到媒体元素时调度。	MediaElement
traitRemove	在从媒体元素中删除某一特征时调度。	MediaElement

属性详细信息

numChildren

属性

numChildren:int [只读]

语言版本:

ActionScript 3.0

产品版本:

OSMF 1.0

运行时版本:

Flash Player 10, AIR 1.5

此媒体组合中子级 MediaElement 的数目。

实现
public function get numChildren():int

构造函数详细信息

()

构造函数

public function CompositeElement()

语言版本:

ActionScript 3.0

产品版本:

OSMF 1.0

运行时版本:

Flash Player 10, AIR 1.5

构造函数。

方法详细信息

addChild

()

方法

public function addChild(child:MediaElement):MediaElement

语言版本:

ActionScript 3.0

产品版本:

OSMF 1.0

运行时版本:

Flash Player 10, AIR 1.5

将指定的子级添加到列表的末尾。等效于 addChildAt(child,numChildren)。

参数

child:MediaElement — 要添加的子级。

MediaElement — 在 child 参数中传递的 MediaElement。

引发

	`ArgumentError` — 如果子级为 `null`。

	`RangeError` — 如果指定的索引小于零或大于列表的长度。

	`Error` — 如果此子级已经是子级。

addChildAt

()

方法

public function addChildAt(child:MediaElement, index:Number):MediaElement

语言版本:

ActionScript 3.0

产品版本:

OSMF 1.0

运行时版本:

Flash Player 10, AIR 1.5

将子级添加到列表的指定索引处。如果此索引处已存在子级，则该子级以及所有后续子级的索引位置都会增加一。

参数

	`child:MediaElement` — 要添加的子级。

	`index:Number` — 要添加子级的索引位置。

MediaElement — 在 child 参数中传递的 MediaElement。

引发

	`ArgumentError` — 如果子级为 `null`。

	`RangeError` — 如果指定的索引小于零或大于列表的长度。

	`Error` — 如果此子级已经是子级。

getChildAt

()

方法

public function getChildAt(index:int):MediaElement

语言版本:

ActionScript 3.0

产品版本:

OSMF 1.0

运行时版本:

Flash Player 10, AIR 1.5

获取指定索引处的子级。

参数

index:int — 从其检索子级的列表中的索引。

MediaElement — 此索引处的子级；如果没有子级，则为 null。

getChildIndex

()

方法

public function getChildIndex(child:MediaElement):int

语言版本:

ActionScript 3.0

产品版本:

OSMF 1.0

运行时版本:

Flash Player 10, AIR 1.5

如果子级位于列表中（这样的话 getChildAt(index) == child），则返回该子级的索引。

参数

child:MediaElement — 要查找的子级。

int — 该子级的索引；如果该子级没有位于列表中，则为 -1。

removeChild

()

方法

public function removeChild(child:MediaElement):MediaElement

语言版本:

ActionScript 3.0

产品版本:

OSMF 1.0

运行时版本:

Flash Player 10, AIR 1.5

删除指定的子级并返回该子级。等效于 removeChildAt(child,getChildIndex(child))。

参数

child:MediaElement — 要删除的子级 MediaElement。

MediaElement — 在 child 参数中传递的 MediaElement。

引发

ArgumentError — 如果该子级不是此组合的子级。

removeChildAt

()

方法

public function removeChildAt(index:int):MediaElement

语言版本:

ActionScript 3.0

产品版本:

OSMF 1.0

运行时版本:

Flash Player 10, AIR 1.5

删除指定索引处的子级并返回该子级。索引位置大于此索引的任何子级的索引位置将会减少一。

参数

index:int — 要从其中删除子级的索引。

MediaElement — 该索引处的子级。

引发

RangeError — 如果指定的索引小于零或大于列表的长度。

法律声明 | 在线隐私策略

CompositeElement - AS3 OSMF

类 x

numChildren