XMLListCollection

包	mx.collections
类	public class XMLListCollection
继承	XMLListCollection ListCollectionView Proxy

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

XMLListCollection 类提供了 XMLList 对象的集合功能，并使本机 XMLList 类的一些方法可用。

MXML 语法

隐藏 MXML 语法

The <mx:XMLListCollection> tag inherits all the attributes of its superclass, and adds the following attributes:

  <mx:XMLListCollection
  Properties
  source="null"
  />

默认 MXML 属性source

相关 API 元素

XMLList
XML

公共属性

隐藏继承的公共属性

显示继承的公共属性

	属性		由以下参数定义
		filterFunction : Function 视图用来消除不符合函数条件的项目的函数。	ListCollectionView
		length : int [只读] 此视图中的项目数。	ListCollectionView
		list : IList 此集合视图所封装的 IList。	ListCollectionView
		sort : ISort 将应用于 ICollectionView 的 ISort。	ListCollectionView
		source : XMLList 此集合的基础 XMLList。	XMLListCollection

受保护的属性

隐藏继承的受保护属性

显示继承的受保护属性

	属性		由以下参数定义
		localIndex : Array 视图经过排序或过滤后，localIndex 属性会在排序或过滤后（已排序、已缩减）的视图中包含按排序顺序显示的项目的数组。	ListCollectionView

公共方法

隐藏继承的公共方法

显示继承的公共方法

	方法		由以下参数定义
		XMLListCollection(source:XMLList = null) 构造函数。	XMLListCollection
		addAll(addList:IList):void 向当前列表添加一组项目，将它们按传入顺序放置在列表的末尾。	ListCollectionView
		addAllAt(addList:IList, index:int):void 向当前列表添加一组项目，将它们放置在传递给函数的索引指定的位置。	ListCollectionView
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void 使用 EventDispatcher 对象注册事件侦听器对象，以使侦听器能够接收事件通知。	ListCollectionView
		addItem(item:Object):void 向列表末尾添加指定项目。	ListCollectionView
		addItemAt(item:Object, index:int):void 在指定的索引处添加项目。	ListCollectionView
		attribute(attributeName:Object):XMLList 调用 XMLList 中每个 XML 对象的 attribute() 方法，并返回与给定 attributeName 相匹配的结果 XMLList。	XMLListCollection
		attributes():XMLList 调用 XMLList 对象中的每个 XML 对象的 attributes() 方法，并返回每个 XML 对象属性的 XMList。	XMLListCollection
		child(propertyName:Object):XMLList 依次调用 XMLList 中的每个 XML 对象的 child() 方法，并返回包含具有指定属性名称的子项的 XMLList。	XMLListCollection
		children():XMLList 调用 XMLList 中的每个 XML 对象的 children() 方法，并返回包含结果的 XMLList。	XMLListCollection
		contains(item:Object):Boolean 返回指示视图是否包含指定对象的信息。	ListCollectionView
		copy():XMLList 返回 XMLList 对象的深副本。	XMLListCollection
		createCursor():IViewCursor 创建使用此视图的新 IViewCursor。	ListCollectionView
		descendants(name:Object = *):XMLList 调用 XMLList 中的每个 XML 对象的 descendants() 方法，并返回包含结果的 XMLList。	XMLListCollection
		disableAutoUpdate():void 防止视图调度对集合本身和集合中的项目的更改。	ListCollectionView
		dispatchEvent(event:Event):Boolean 将事件调度到事件流中。	ListCollectionView
		elements(name:String = "*"):XMLList 调用 XMLList 中的每个 XML 对象的 elements() 方法。	XMLListCollection
		enableAutoUpdate():void 启用自动更新。	ListCollectionView
		getItemAt(index:int, prefetch:int = 0):Object 获取指定索引处的项目。	ListCollectionView
		getItemIndex(item:Object):int 如果项目位于列表中（这样的话 getItemAt(index) == item），则返回该项目的索引。	ListCollectionView
		hasEventListener(type:String):Boolean 检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。	ListCollectionView
		initialized(document:Object, id:String):void 如果 ListCollectionView 是使用 MXML 标签创建的，则由 MXML 编译器自动调用。	ListCollectionView
		itemUpdated(item:Object, property:Object = null, oldValue:Object = null, newValue:Object = null):void 通知视图，某个项目已更新。	ListCollectionView
		refresh():Boolean 将排序和滤镜应用到视图。	ListCollectionView
		removeAll():void 删除列表中的所有项目。	ListCollectionView
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void 从 EventDispatcher 对象中删除侦听器。	ListCollectionView
		removeItemAt(index:int):Object 删除指定索引处的项目并返回该项目。	ListCollectionView
		setItemAt(item:Object, index:int):Object 在指定的索引处放置项目。	ListCollectionView
		text():XMLList 调用 XMLList 中的每个 XML 对象的 text() 方法，并返回包含结果的 XMLList。	XMLListCollection
		toArray():Array 返回与 IList 实现的填充顺序相同的 Array。	ListCollectionView
		toString():String [覆盖] 通过对 XMLList 中的每个 XML 对象调用 toString() 方法返回 XMLList 的字符串表示形式。	XMLListCollection
		toXMLString():String 通过对 XMLList 中的每个 XML 对象调用 toXMLString() 方法返回 XMLList 的字符串表示形式。	XMLListCollection
		willTrigger(type:String):Boolean 检查是否用此 EventDispatcher 对象或其任何祖代为指定事件类型注册了事件侦听器。	ListCollectionView

事件

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

隐藏继承的事件

显示继承的事件

	事件		摘要	由以下参数定义
		collectionChange	以某种方式更新 ICollectionView 后调度。	ListCollectionView

属性详细信息

source

属性

source:XMLList

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

此集合的基础 XMLList。XMLListCollection对象不呈示对源 XMLList 对象直接进行的任何更改。始终使用 XMLListCollection 方法修改该集合。

此属性可用作数据绑定的源。修改此属性后，将调度 listChanged 事件。

实现
public function get source():XMLList
public function set source(value:XMLList):void

构造函数详细信息

()

构造函数

public function XMLListCollection(source:XMLList = null)

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

构造函数。

使用指定的 XMLList 对象创建新的 XMLListCollection 对象。

参数

source:XMLList (default = null) — 包含将由 XMLListCollection 对象表示的数据的 XMLList 对象。

方法详细信息

attribute

()

方法

public function attribute(attributeName:Object):XMLList

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

调用 XMLList 中的每个 XML 对象的 attribute() 方法，并返回与给定的 attributeName 相匹配的结果 XMLList。

参数

attributeName:Object — 要在 XMLList 的 XML 对象中匹配的属性。

XMLList — 与 XML 对象匹配的 XMLList。

相关 API 元素

XML.attribute()

attributes

()

方法

public function attributes():XMLList

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

调用 XMLList 对象中的每个 XML 对象的 attributes() 方法，并返回每个 XML 对象属性的 XMList。

XMLList — 包含列有属性的结果 XML 对象的 XMLList。

相关 API 元素

XML.attributes()

child

()

方法

public function child(propertyName:Object):XMLList

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

依次调用 XMLList 中的每个 XML 对象的 child() 方法，并返回包含具有指定属性名称的子项的 XMLList。

参数

propertyName:Object — 要匹配的属性。

XMLList — 与原始 XMLList 中 XML 对象的子项相匹配的 XMLList。

相关 API 元素

XML.child()

children

()

方法

public function children():XMLList

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

调用 XMLList 中的每个 XML 对象的 children() 方法，并返回包含结果的 XMLList。

XMLList — 原始 XMLList 中 XML 对象的子项的 XMLList。

相关 API 元素

XML.children()

copy

()

方法

public function copy():XMLList

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

返回 XMLList 对象的深副本。

XMLList — XMLList 对象的副本。

descendants

()

方法

public function descendants(name:Object = *):XMLList

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

调用 XMLList 中的每个 XML 对象的 descendants() 方法，并返回包含结果的 XMLList。name 参数会传递给 XML 对象的 descendants() 方法。如果未指定参数，则字符串“*”将传递给 descendants() 方法。

参数

name:Object (default = *) — 要匹配的元素的名称。

XMLList — 原始 XMLList 中 XML 对象的匹配后代（子项、孙项等）的 XMLList。

相关 API 元素

XML.descendants()

elements

()

方法

public function elements(name:String = "*"):XMLList

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

调用 XMLList 中的每个 XML 对象的 elements() 方法。name 参数会传递给 XML 对象的 elements() 方法。如果未指定参数，则字符串“*”将传递给 elements() 方法。

参数

name:String (default = "*") — 要匹配的元素的名称。

XMLList — 原始 XMLList 中 XML 对象的匹配子项元素的 XMLList。

相关 API 元素

XML.elements()

text

()

方法

public function text():XMLList

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

调用 XMLList 中的每个 XML 对象的 text() 方法，并返回包含结果的 XMLList。

XMLList — 包含结果的 XMLList。

相关 API 元素

XML.text()

toString

()

方法

override public function toString():String

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

通过对 XMLList 中的每个 XML 对象调用 toString() 方法返回 XMLList 的字符串表示形式。如果将 XML 类的 prettyPrinting 属性设置为 true，则 XMLList 中每个 XML 对象的结果将通过回车符进行分隔。相反，如果将 prettyPrinting 设置为 false，则这些结果只是会连接起来，而不会通过回车符进行分隔

toString() 方法将在包含简单内容的 XML 对象的返回字符串中除去以下内容：开始标签、属性、命名空间声明和结束标签。如果要在包含简单内容的 XML 对象的返回字符串中保留这些内容，请使用 toXMLString() 方法。

String — XMLList 对象的字符串表示形式。

相关 API 元素

XML.prettyPrinting

toXMLString

()

方法

public function toXMLString():String

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

通过对 XMLList 中的每个 XML 对象调用 toXMLString() 方法返回 XMLList 的字符串表示形式。如果将 XML 类的 prettyPrinting 属性设置为 true，则 XMLList 中每个 XML 对象的结果将通过回车符进行分隔。相反，如果将 prettyPrinting 设置为 false，这些结果会连接起来，而不会通过回车符进行分隔。

toXMLString() 方法将在包含简单内容的 XML 对象的返回字符串中保留以下内容：开始标签、属性、命名空间声明和结束标签。如果要在包含简单内容的 XML 对象的返回字符串中去除这些内容，请使用 toString() 方法。

String — XMLList 的字符串表示形式。

相关 API 元素

XML.prettyPrinting

法律声明 | 在线隐私策略

XMLListCollection - AS3 Flex

包x

语言元素

附录

包 mx.collections

source