Packagemx.automation
Interfacepublic interface IAutomationObject
ImplementorsUIComponent, UITextField

The IAutomationObject interface defines the interface for a delegate object that implements automation for a component.



Public Properties
 PropertyDefined by
  automationDelegate : Object
The delegate object that is handling the automation-related functionality.
IAutomationObject
  automationName : String
Name that can be used as an identifier for this object.
IAutomationObject
  automationTabularData : Object
[read-only] An implementation of the IAutomationTabularData interface, which can be used to retrieve the data.
IAutomationObject
  automationValue : Array
[read-only] This value generally corresponds to the rendered appearance of the object and should be usable for correlating the identifier with the object as it appears visually within the application.
IAutomationObject
  numAutomationChildren : int
[read-only] The number of automation children this container has.
IAutomationObject
  showInAutomationHierarchy : Boolean
A flag that determines if an automation object shows in the automation hierarchy.
IAutomationObject
Public Methods
 MethodDefined by
  
Returns a set of properties that identify the child within this container.
IAutomationObject
  
Provides the automation object at the specified index.
IAutomationObject
  
replayAutomatableEvent(event:Event):Boolean
Replays the specified event.
IAutomationObject
  
resolveAutomationIDPart(criteria:Object):Array
Resolves a child by using the id provided.
IAutomationObject
Property detail
automationDelegateproperty
automationDelegate:Object  [read-write]

The delegate object that is handling the automation-related functionality. Automation sets this when it creates the delegate object.

Implementation
    public function get automationDelegate():Object
    public function set automationDelegate(value:Object):void
automationNameproperty 
automationName:String  [read-write]

Name that can be used as an identifier for this object.

Implementation
    public function get automationName():String
    public function set automationName(value:String):void
automationTabularDataproperty 
automationTabularData:Object  [read-only]

An implementation of the IAutomationTabularData interface, which can be used to retrieve the data.

Implementation
    public function get automationTabularData():Object
automationValueproperty 
automationValue:Array  [read-only]

This value generally corresponds to the rendered appearance of the object and should be usable for correlating the identifier with the object as it appears visually within the application.

Implementation
    public function get automationValue():Array
numAutomationChildrenproperty 
numAutomationChildren:int  [read-only]

The number of automation children this container has. This sum should not include any composite children, though it does include those children not significant within the automation hierarchy.

Implementation
    public function get numAutomationChildren():int
showInAutomationHierarchyproperty 
showInAutomationHierarchy:Boolean  [read-write]

A flag that determines if an automation object shows in the automation hierarchy. Children of containers that are not visible in the hierarchy appear as children of the next highest visible parent. Typically containers used for layout, such as boxes and Canvas, do not appear in the hierarchy.

Some controls force their children to appear in the hierarchy when appropriate. For example a List will always force item renderers, including boxes, to appear in the hierarchy. Implementers must support setting this property to true.

Implementation
    public function get showInAutomationHierarchy():Boolean
    public function set showInAutomationHierarchy(value:Boolean):void
Method detail
createAutomationIDPart()method
public function createAutomationIDPart(child:IAutomationObject):Object

Returns a set of properties that identify the child within this container. These values should not change during the lifespan of the application.

Parameters
child:IAutomationObject — Child for which to provide the id.

Returns
Object — Sets of properties describing the child which can later be used to resolve the component.
getAutomationChildAt()method 
public function getAutomationChildAt(index:int):IAutomationObject

Provides the automation object at the specified index. This list should not include any children that are composites.

Parameters
index:int — The index of the child to return

Returns
IAutomationObject — The child at the specified index.
replayAutomatableEvent()method 
public function replayAutomatableEvent(event:Event):Boolean

Replays the specified event. A component author should probably call super.replayAutomatableEvent in case default replay behavior has been defined in a superclass.

Parameters
event:Event — The event to replay.

Returns
Booleantrue if a replay was successful.
resolveAutomationIDPart()method 
public function resolveAutomationIDPart(criteria:Object):Array

Resolves a child by using the id provided. The id is a set of properties as provided by the createAutomationIDPart() method.

Parameters
criteria:Object — Set of properties describing the child. The criteria can contain regular expression values resulting in multiple children being matched.

Returns
Array — Array of children that matched the criteria or null if no children could not be resolved.