Packagecom.degrafa.core.collections
Classpublic class DegrafaCollection
InheritanceDegrafaCollection Inheritance DegrafaObject
SubclassesDisplayObjectCollection, FillCollection, GeometryCollection, GradientStopsCollection, GraphicPointCollection, GraphicPointEXCollection, GraphicsCollection, GraphicSkinCollection, SegmentsCollection, StrokeCollection, TransformCollection

The Degrafa collection stores a collection of objects of a specific type and is the base class for all collection objects.

Default MXML Propertyitems



Public Properties
 PropertyDefined by
 Inheriteddocument : Object
The MXML document that created this object.
DegrafaObject
 InheritedenableEvents : Boolean
Enable events for this object.
DegrafaObject
  enableTypeChecking : Boolean
Allows internal type checking to be turned off.
DegrafaCollection
 InheritedhasEventManager : Boolean
Tests to see if a EventDispatcher instance has been created for this object.
DegrafaObject
 Inheritedid : String
The identifier used by document to refer to this object.
DegrafaObject
  items : Array
An array of items being stored in this collection.
DegrafaCollection
 Inheritedname : String
The name that refers to this object.
DegrafaObject
 InheritedsuppressEventProcessing : Boolean
Temporarily suppress event processing for this object.
DegrafaObject
Protected Properties
 PropertyDefined by
 InheritedeventDispatcher : EventDispatcher
EventDispatcher instance for this object.
DegrafaObject
Public Methods
 MethodDefined by
  
DegrafaCollection(type:Class, array:Array = null, suppressEvents:Boolean = false, enableTypeChecking:Boolean = true)
Constructor.
DegrafaCollection
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registers an event listener object with an EventDispatcher object so that the listener receives notification of an event.
DegrafaObject
  
addListener(value:*):void
Addes a property change event listener to the passed object.
DegrafaCollection
  
addListeners():void
Addes a property change event listener to each item in the collection.
DegrafaCollection
  
concat(... args):Array
Concatenates the elements specified in the parameters with the elements in an array and creates a new array.
DegrafaCollection
 Inherited
dispatchEvent(evt:Event):Boolean
Dispatches an event into the event flow.
DegrafaObject
 Inherited
dispatchPropertyChange(bubbles:Boolean = false, property:Object = null, oldValue:Object = null, newValue:Object = null, source:Object = null):Boolean
Dispatches an property change event into the event flow.
DegrafaObject
  
every(callback:Function, thisObject:* = null):Boolean
Executes a test function on each item in the array until an item is reached that returns false for the specified function.
DegrafaCollection
  
filter(callback:Function, thisObject:* = null):Array
Executes a test function on each item in the array and constructs a new array for all items that return true for the specified function.
DegrafaCollection
  
forEach(callback:Function, thisObject:* = null):void
Executes a function on each item in the array.
DegrafaCollection
 Inherited
hasEventListener(type:String):Boolean
Checks whether the EventDispatcher object has any listeners registered for a specific type of event.
DegrafaObject
  
indexOf(searchElement:*, fromIndex:int = 0):int
Searches for an item in an array by using strict equality (===) and returns the index position of the item.
DegrafaCollection
 Inherited
initChange(property:String, oldValue:Object, newValue:Object, source:Object):void
Helper function for dispatching property changes
DegrafaObject
 Inherited
initialized(document:Object, id:String):void
Called after the implementing object has been created and all component properties specified on the MXML tag have been initialized.
DegrafaObject
  
join(sep:*):String
Converts the elements in an array to strings, inserts the specified separator between the elements, concatenates them, and returns the resulting string.
DegrafaCollection
  
lastIndexOf(searchElement:*, fromIndex:int = 0x7fffffff):int
Searches for an item in an array, working backward from the last item, and returns the index position of the matching item using strict equality (===).
DegrafaCollection
  
map(callback:Function, thisObject:* = null):Array
Executes a function on each item in an array, and constructs a new array of items corresponding to the results of the function on each item in the original array.
DegrafaCollection
  
pop():*
Removes the last element from an array and returns the value of that element.
DegrafaCollection
  
propertyChangeHandler(event:PropertyChangeEvent):void
Property change event handler for this collection.
DegrafaCollection
  
push(... args):uint
Adds one or more elements to the end of an array and returns the new length of the array.
DegrafaCollection
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Removes a listener from the EventDispatcher object.
DegrafaObject
  
removeListener(value:*):void
Removes the property change event listener from the passed object.
DegrafaCollection
  
Removes the property change event listener from each item in the collection.
DegrafaCollection
  
reverse():Array
Reverses the array in place.
DegrafaCollection
  
shift():*
Removes the first element from an array and returns that element.
DegrafaCollection
  
slice(startIndex:int = 0, endIndex:int = 16777215):Array
Returns a new array that consists of a range of elements from the original array, without modifying the original array.
DegrafaCollection
  
some(callback:Function, thisObject:* = null):Boolean
Executes a test function on each item in the array until an item is reached that returns true.
DegrafaCollection
  
sort(... args):Array
Sorts the elements in an array.
DegrafaCollection
  
sortOn(fieldName:Object, options:Object = null):Array
Sorts the elements in an array according to one or more fields in the array.
DegrafaCollection
  
splice(startIndex:int, deleteCount:uint, ... values):Array
Adds elements to and removes elements from an array.
DegrafaCollection
  
unshift(... args):uint
Adds one or more elements to the beginning of an array and returns the new length of the array.
DegrafaCollection
 Inherited
willTrigger(type:String):Boolean
Checks whether an event listener is registered with this EventDispatcher object or any of its ancestors for the specified event type.
DegrafaObject
Protected Methods
 MethodDefined by
  
_addItem(value:*):*
Adds a new item to the collection.
DegrafaCollection
  
_addItemAt(value:*, index:Number):*
Add a item at the given index.
DegrafaCollection
  
_getItemAt(index:Number):*
Return a item at the given index.
DegrafaCollection
  
_getItemIndex(value:*):int
Return the index for the item in the collection.
DegrafaCollection
  
_removeItem(value:*):*
Removes a item from the collection.
DegrafaCollection
  
_removeItemAt(index:Number):*
Removes a item from the collection.
DegrafaCollection
  
_setItemIndex(value:*, newIndex:Number):Boolean
Change the position of an item in the collection
DegrafaCollection
Events
 EventSummaryDefined by
 Inherited  DegrafaObject
 Inherited  DegrafaObject
Property detail
enableTypeCheckingproperty
enableTypeChecking:Boolean  [read-write]

Allows internal type checking to be turned off.

Implementation
    public function get enableTypeChecking():Boolean
    public function set enableTypeChecking(value:Boolean):void
itemsproperty 
items:Array  [read-write]

An array of items being stored in this collection.

Implementation
    public function get items():Array
    public function set items(value:Array):void
Constructor detail
DegrafaCollection()constructor
public function DegrafaCollection(type:Class, array:Array = null, suppressEvents:Boolean = false, enableTypeChecking:Boolean = true)

Constructor.

The Degrafa collection constructor accepts 4 optional arguments that specify it's type, an array of values of the expected type to be added and 2 event operation flags.

Parameters
type:Class — An class value specifing the types of objects being stored here.
 
array:Array (default = null) — An array of objects that are of the specified type.
 
suppressEvents:Boolean (default = false) — A boolean value indicating if events should not be dispatched for this collection.
 
enableTypeChecking:Boolean (default = true) — A boolean value indicating if type checking should be performed.
Method detail
_addItem()method
protected function _addItem(value:*):*

Adds a new item to the collection.

Parameters
value:* — The item to add.

Returns
* — The item added.
_addItemAt()method 
protected function _addItemAt(value:*, index:Number):*

Add a item at the given index.

Parameters
value:* — The item to add to the collection.
 
index:Number — The index at which to add the item.

Returns
* — The item added.
_getItemAt()method 
protected function _getItemAt(index:Number):*

Return a item at the given index.

Parameters
index:Number — The item index to return.

Returns
* — The item requested.
_getItemIndex()method 
protected function _getItemIndex(value:*):int

Return the index for the item in the collection.

Parameters
value:* — The item to find.

Returns
int — The index location of the item.
_removeItem()method 
protected function _removeItem(value:*):*

Removes a item from the collection.

Parameters
value:* — The item to remove.

Returns
* — The item removed.
_removeItemAt()method 
protected function _removeItemAt(index:Number):*

Removes a item from the collection.

Parameters
index:Number — The item index to remove.

Returns
* — The removed item.
_setItemIndex()method 
protected function _setItemIndex(value:*, newIndex:Number):Boolean

Change the position of an item in the collection

Parameters
value:* — The items new index.
 
newIndex:Number — The item to be repositioned.

Returns
Boolean — Returns true is the item was repositioned.
addListener()method 
public function addListener(value:*):void

Addes a property change event listener to the passed object.

Parameters
value:*
addListeners()method 
public function addListeners():void

Addes a property change event listener to each item in the collection.

concat()method 
public function concat(... args):Array

Concatenates the elements specified in the parameters with the elements in an array and creates a new array.

Parameters
... args

Returns
Array

See also

Array
every()method 
public function every(callback:Function, thisObject:* = null):Boolean

Executes a test function on each item in the array until an item is reached that returns false for the specified function.

Parameters
callback:Function
 
thisObject:* (default = null)

Returns
Boolean

See also

Array
filter()method 
public function filter(callback:Function, thisObject:* = null):Array

Executes a test function on each item in the array and constructs a new array for all items that return true for the specified function.

Parameters
callback:Function
 
thisObject:* (default = null)

Returns
Array

See also

Array
forEach()method 
public function forEach(callback:Function, thisObject:* = null):void

Executes a function on each item in the array.

Parameters
callback:Function
 
thisObject:* (default = null)

See also

Array
indexOf()method 
public function indexOf(searchElement:*, fromIndex:int = 0):int

Searches for an item in an array by using strict equality (===) and returns the index position of the item.

Parameters
searchElement:*
 
fromIndex:int (default = 0)

Returns
int

See also

Array
join()method 
public function join(sep:*):String

Converts the elements in an array to strings, inserts the specified separator between the elements, concatenates them, and returns the resulting string.

Parameters
sep:*

Returns
String

See also

Array
lastIndexOf()method 
public function lastIndexOf(searchElement:*, fromIndex:int = 0x7fffffff):int

Searches for an item in an array, working backward from the last item, and returns the index position of the matching item using strict equality (===).

Parameters
searchElement:*
 
fromIndex:int (default = 0x7fffffff)

Returns
int

See also

Array
map()method 
public function map(callback:Function, thisObject:* = null):Array

Executes a function on each item in an array, and constructs a new array of items corresponding to the results of the function on each item in the original array.

Parameters
callback:Function
 
thisObject:* (default = null)

Returns
Array

See also

Array
pop()method 
public function pop():*

Removes the last element from an array and returns the value of that element.

Returns
*

See also

Array
propertyChangeHandler()method 
public function propertyChangeHandler(event:PropertyChangeEvent):void

Property change event handler for this collection.

Parameters
event:PropertyChangeEvent
push()method 
public function push(... args):uint

Adds one or more elements to the end of an array and returns the new length of the array.

Parameters
... args

Returns
uint

See also

Array
removeListener()method 
public function removeListener(value:*):void

Removes the property change event listener from the passed object.

Parameters
value:*
removeListeners()method 
public function removeListeners():void

Removes the property change event listener from each item in the collection.

reverse()method 
public function reverse():Array

Reverses the array in place.

Returns
Array

See also

Array
shift()method 
public function shift():*

Removes the first element from an array and returns that element.

Returns
*

See also

Array
slice()method 
public function slice(startIndex:int = 0, endIndex:int = 16777215):Array

Returns a new array that consists of a range of elements from the original array, without modifying the original array.

Parameters
startIndex:int (default = 0)
 
endIndex:int (default = 16777215)

Returns
Array

See also

Array
some()method 
public function some(callback:Function, thisObject:* = null):Boolean

Executes a test function on each item in the array until an item is reached that returns true.

Parameters
callback:Function
 
thisObject:* (default = null)

Returns
Boolean

See also

Array
sort()method 
public function sort(... args):Array

Sorts the elements in an array.

Parameters
... args

Returns
Array

See also

Array
sortOn()method 
public function sortOn(fieldName:Object, options:Object = null):Array

Sorts the elements in an array according to one or more fields in the array.

Parameters
fieldName:Object
 
options:Object (default = null)

Returns
Array

See also

Array
splice()method 
public function splice(startIndex:int, deleteCount:uint, ... values):Array

Adds elements to and removes elements from an array.

Parameters
startIndex:int
 
deleteCount:uint
 
... values

Returns
Array

See also

Array
unshift()method 
public function unshift(... args):uint

Adds one or more elements to the beginning of an array and returns the new length of the array.

Parameters
... args

Returns
uint

See also

Array