Packagemx.collections
Classpublic class XMLListCollection
InheritanceXMLListCollection Inheritance ListCollectionView Inheritance flash.utils.Proxy

Language Version : ActionScript 3.0
Product Version : Flex 3
Runtime Versions : Flash Player 9, AIR 1.1

The XMLListCollection class provides collection functionality to an XMLList object and makes available some of the methods of the native XMLList class.

MXML SyntaxexpandedHide MXML Syntax

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

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

Default MXML Propertysource

See also

XMLList
XML


Public Properties
 PropertyDefined By
 InheritedcomplexFieldWatcher : ComplexFieldChangeWatcher
ListCollectionView
 InheritedfilterFunction : Function
A function that the view will use to eliminate items that do not match the function's criteria.
ListCollectionView
 Inheritedlength : int
[read-only] The number of items in this view.
ListCollectionView
 Inheritedlist : IList
The IList that this collection view wraps.
ListCollectionView
 Inheritedsort : ISort
The ISort that will be applied to the ICollectionView.
ListCollectionView
  source : XMLList
The underlying XMLList for this collection.
XMLListCollection
Protected Properties
 PropertyDefined By
 InheritedlocalIndex : Array
When the view is sorted or filtered the localIndex property contains an array of items in the sorted or filtered (ordered, reduced) view, in the sorted order.
ListCollectionView
Public Methods
 MethodDefined By
  
XMLListCollection(source:XMLList = null)
Constructor.
XMLListCollection
 Inherited
addAll(addList:IList):void
Adds a list of items to the current list, placing them at the end of the list in the order they are passed.
ListCollectionView
 Inherited
addAllAt(addList:IList, index:int):void
Adds a list of items to the current list, placing them at the position index passed in to the function.
ListCollectionView
 Inherited
addEventListener(eventType:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
ListCollectionView
 Inherited
addItem(item:Object):void
Adds the specified item to the end of the list.
ListCollectionView
 Inherited
addItemAt(item:Object, index:int):void
Adds the item at the specified index.
ListCollectionView
  
attribute(attributeName:Object):XMLList
Calls the attribute() method of each XML object in the XMLList and returns an XMLList of the results, which match the given attributeName.
XMLListCollection
  
attributes():XMLList
Calls the attributes() method of each XML object in the XMLList object and returns an XMList of attributes for each XML object.
XMLListCollection
  
child(propertyName:Object):XMLList
Calls the child() method of each XML object in the XMLList and returns an XMLList containing the children of with the specified property name, in order.
XMLListCollection
  
children():XMLList
Calls the children() method of each XML object in the XMLList and returns an XMLList containing the results.
XMLListCollection
 Inherited
contains(item:Object):Boolean
Returns whether the view contains the specified object.
ListCollectionView
  
copy():XMLList
Returns a deep copy of the XMLList object.
XMLListCollection
 Inherited
Creates a new IViewCursor that works with this view.
ListCollectionView
  
descendants(name:Object = *):XMLList
Calls the descendants() method of each XML object in the XMLList and returns an XMLList containing the results.
XMLListCollection
 Inherited
Prevents changes to the collection itself and items within the collection from being dispatched by the view.
ListCollectionView
 Inherited
dispatchEvent(event:Event):Boolean
ListCollectionView
  
elements(name:String = *):XMLList
Calls the elements() method of each XML object in the XMLList.
XMLListCollection
 Inherited
Enables auto-updating.
ListCollectionView
 Inherited
getItemAt(index:int, prefetch:int = 0):Object
Gets the item at the specified index.
ListCollectionView
 Inherited
getItemIndex(item:Object):int
Returns the index of the item if it is in the list such that getItemAt(index) == item.
ListCollectionView
 Inherited
hasEventListener(eventType:String):Boolean
ListCollectionView
 Inherited
initialized(document:Object, id:String):void
Called automatically by the MXML compiler when the ListCollectionView is created using an MXML tag.
ListCollectionView
 Inherited
itemUpdated(item:Object, property:Object = null, oldValue:Object = null, newValue:Object = null):void
Notifies the view that an item has been updated.
ListCollectionView
 Inherited
refresh():Boolean
Applies the sort and filter to the view.
ListCollectionView
 Inherited
removeAll():void
Remove all items from the list.
ListCollectionView
 Inherited
removeEventListener(eventType:String, listener:Function, useCapture:Boolean = false):void
ListCollectionView
 Inherited
removeItem(item:Object):Boolean
Removes the specified item from this list, should it exist.
ListCollectionView
 Inherited
removeItemAt(index:int):Object
Removes the item at the specified index and returns it.
ListCollectionView
 Inherited
setItemAt(item:Object, index:int):Object
Places the item at the specified index.
ListCollectionView
  
text():XMLList
Calls the text() method of each XML object in the XMLList and returns an XMLList containing the results.
XMLListCollection
 Inherited
toArray():Array
Returns an Array that is populated in the same order as the IList implementation.
ListCollectionView
  
toString():String
[override] Returns a string representation of the XMLList by calling the toString() method for each XML object in the XMLList.
XMLListCollection
  
toXMLString():String
Returns a string representation of the XMLList by calling the toXMLString() method for each XML object in the XMLList.
XMLListCollection
 Inherited
willTrigger(eventType:String):Boolean
ListCollectionView
Events
 Event Summary Defined By
 InheritedDispatched when the ICollectionView has been updated in some way.ListCollectionView
Property Detail
sourceproperty
source:XMLList

Language Version : ActionScript 3.0
Product Version : Flex 3
Runtime Versions : Flash Player 9, AIR 1.1

The underlying XMLList for this collection. The XMLListCollection object does not represent any changes that you make directly to the source XMLList object. Always use the XMLListCollection methods to modify the collection.

This property can be used as the source for data binding.


Implementation
    public function get source():XMLList
    public function set source(value:XMLList):void
Constructor Detail
XMLListCollection()Constructor
public function XMLListCollection(source:XMLList = null)

Language Version : ActionScript 3.0
Product Version : Flex 3
Runtime Versions : Flash Player 9, AIR 1.1

Constructor.

Creates a new XMLListCollection object using the specified XMLList object.

Parameters
source:XMLList (default = null) — The XMLList object containing the data to be represented by the XMLListCollection object.
Method Detail
attribute()method
public function attribute(attributeName:Object):XMLList

Language Version : ActionScript 3.0
Product Version : Flex 3
Runtime Versions : Flash Player 9, AIR 1.1

Calls the attribute() method of each XML object in the XMLList and returns an XMLList of the results, which match the given attributeName.

Parameters

attributeName:Object — The attribute that you want to match in the XML objects of the XMLList.

Returns
XMLList — The XMLList of matching XML objects.

See also

XML.attribute()
attributes()method 
public function attributes():XMLList

Language Version : ActionScript 3.0
Product Version : Flex 3
Runtime Versions : Flash Player 9, AIR 1.1

Calls the attributes() method of each XML object in the XMLList object and returns an XMList of attributes for each XML object.

Returns
XMLList — The XMLList containing the resulting XML objects, listing the attributes.

See also

XML.attributes()
child()method 
public function child(propertyName:Object):XMLList

Language Version : ActionScript 3.0
Product Version : Flex 3
Runtime Versions : Flash Player 9, AIR 1.1

Calls the child() method of each XML object in the XMLList and returns an XMLList containing the children of with the specified property name, in order.

Parameters

propertyName:Object — The propery to match.

Returns
XMLList — An XMLList of matching children of the XML objects in the original XMLList.

See also

XML.child()
children()method 
public function children():XMLList

Language Version : ActionScript 3.0
Product Version : Flex 3
Runtime Versions : Flash Player 9, AIR 1.1

Calls the children() method of each XML object in the XMLList and returns an XMLList containing the results.

Returns
XMLList — An XMLList of children of the XML objects in the original XMLList.

See also

XML.children()
copy()method 
public function copy():XMLList

Language Version : ActionScript 3.0
Product Version : Flex 3
Runtime Versions : Flash Player 9, AIR 1.1

Returns a deep copy of the XMLList object.

Returns
XMLList — The copy of the XMLList object.
descendants()method 
public function descendants(name:Object = *):XMLList

Language Version : ActionScript 3.0
Product Version : Flex 3
Runtime Versions : Flash Player 9, AIR 1.1

Calls the descendants() method of each XML object in the XMLList and returns an XMLList containing the results. The name parameter is passed to the XML object's descendants() method. If you do not specify a parameter, the string "*" is passed to the descendants() method.

Parameters

name:Object (default = *) — The name of the elements to match.

Returns
XMLList — XMLList of the matching descendents (children, grandchildren, etc.) of the XML objects in the original XMLList.

See also

XML.descendants()
elements()method 
public function elements(name:String = *):XMLList

Language Version : ActionScript 3.0
Product Version : Flex 3
Runtime Versions : Flash Player 9, AIR 1.1

Calls the elements() method of each XML object in the XMLList. The name parameter is passed to the XML object's elements() method. If you do not specify a parameter, the string "*" is passed to the elements() method.

Parameters

name:String (default = *) — The name of the elements to match.

Returns
XMLList — XMLList of the matching child elements of the XML objects in the original XMLList.

See also

XML.elements()
text()method 
public function text():XMLList

Language Version : ActionScript 3.0
Product Version : Flex 3
Runtime Versions : Flash Player 9, AIR 1.1

Calls the text() method of each XML object in the XMLList and returns an XMLList containing the results.

Returns
XMLList — The XMLList that contains the result.

See also

XML.text()
toString()method 
override public function toString():String

Language Version : ActionScript 3.0
Product Version : Flex 3
Runtime Versions : Flash Player 9, AIR 1.1

Returns a string representation of the XMLList by calling the toString() method for each XML object in the XMLList. If the prettyPrinting property of the XML class is set to true, then the results for each XML object in the XMLList are separated by the return character. Otherwise, if prettyPrinting is set to false, then the results are simply concatenated, without separating return characters.

The toString() method strips out the following in the returned string for an XML object that has simple content: the start tag, attributes, namespace declarations, and the end tag. Use the toXMLString() method if you want to preserve these in the returned string for XML objects with simple content.

Returns
String — The string representation of the XMLList object.

See also

XML.prettyPrinting
toXMLString()method 
public function toXMLString():String

Language Version : ActionScript 3.0
Product Version : Flex 3
Runtime Versions : Flash Player 9, AIR 1.1

Returns a string representation of the XMLList by calling the toXMLString() method for each XML object in the XMLList. If the prettyPrinting property of the XML class is set to true, then the results for each XML object in the XMLList are separated by the return character. Otherwise, if prettyPrinting is set to false, then the results are concatenated, without separating return characters.

The toXMLString() method preserves the following in the returned string for an XML object that has simple content: the start tag, attributes, namespace declarations, and the end tag. Use the toString() method if you want to strip these from the returned string for XML objects with simple content.

Returns
String — The string representation of the XMLList.

See also

XML.prettyPrinting