Packagespark.events
Classpublic class ElementExistenceEvent
InheritanceElementExistenceEvent Inheritance flash.events.Event

Language Version : ActionScript 3.0
Product Version : Flex 4
Runtime Versions : Flash Player 10, AIR 1.5

The ElementExistenceEvent class represents events that are dispatched when an element of a Group is created or destroyed.

See also

spark.components.Group


Public Properties
 PropertyDefined By
  element : IVisualElement
Reference to the visual element that was added or removed.
ElementExistenceEvent
  index : int
The index where the element was added or removed.
ElementExistenceEvent
Public Methods
 MethodDefined By
  
ElementExistenceEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, element:IVisualElement = null, index:int = -1)
Constructor.
ElementExistenceEvent
Public Constants
 ConstantDefined By
  ELEMENT_ADD : String = elementAdd
[static] The ElementExistenceEvent.ELEMENT_ADD constant defines the value of the type property of the event object for an elementAdd event.
ElementExistenceEvent
  ELEMENT_REMOVE : String = elementRemove
[static] The ElementExistenceEvent.ELEMENT_REMOVE constant defines the value of the type property of the event object for an elementRemove event.
ElementExistenceEvent
Property Detail
elementproperty
public var element:IVisualElement

Language Version : ActionScript 3.0
Product Version : Flex 4
Runtime Versions : Flash Player 10, AIR 1.5

Reference to the visual element that was added or removed.

indexproperty 
public var index:int

Language Version : ActionScript 3.0
Product Version : Flex 4
Runtime Versions : Flash Player 10, AIR 1.5

The index where the element was added or removed.

Constructor Detail
ElementExistenceEvent()Constructor
public function ElementExistenceEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, element:IVisualElement = null, index:int = -1)

Language Version : ActionScript 3.0
Product Version : Flex 4
Runtime Versions : Flash Player 10, AIR 1.5

Constructor.

Parameters
type:String — The event type; indicates the action that caused the event.
 
bubbles:Boolean (default = false) — Specifies whether the event can bubble up the display list hierarchy.
 
cancelable:Boolean (default = false) — Specifies whether the behavior associated with the event can be prevented.
 
element:IVisualElement (default = null) — Reference to the element that was added or removed.
 
index:int (default = -1) — The index where the element was added or removed.
Constant Detail
ELEMENT_ADDConstant
public static const ELEMENT_ADD:String = elementAdd

Language Version : ActionScript 3.0
Product Version : Flex 4
Runtime Versions : Flash Player 10, AIR 1.5

The ElementExistenceEvent.ELEMENT_ADD constant defines the value of the type property of the event object for an elementAdd event.

The properties of the event object have the following values:

PropertyValue
bubblesfalse
cancelablefalse
currentTargetThe Object that defines the event listener that handles the event. For example, if you use myButton.addEventListener() to register an event listener, myButton is the value of the currentTarget.
elementContains a reference to the visual element that was added.
indexThe index where the visual element that was added.
targetThe Object that dispatched the event; it is not always the Object listening for the event. Use the currentTarget property to always access the Object listening for the event.

ELEMENT_REMOVEConstant 
public static const ELEMENT_REMOVE:String = elementRemove

Language Version : ActionScript 3.0
Product Version : Flex 4
Runtime Versions : Flash Player 10, AIR 1.5

The ElementExistenceEvent.ELEMENT_REMOVE constant defines the value of the type property of the event object for an elementRemove event.

The properties of the event object have the following values:

PropertyValue
bubblesfalse
cancelablefalse
currentTargetThe Object that defines the event listener that handles the event. For example, if you use myButton.addEventListener() to register an event listener, myButton is the value of the currentTarget.
elementA reference to the visual element that is about to be removed.
indexThe index of visual element that is being removed.
targetThe Object that dispatched the event; it is not always the Object listening for the event. Use the currentTarget property to always access the Object listening for the event.