| 套件 | mx.automation |
| 介面 | public interface IAutomationManager extends IEventDispatcher |
| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
更多範例
| 屬性 | 定義自 | ||
|---|---|---|---|
| automationEnvironment : Object
The automation environment for this automation manager. | IAutomationManager | ||
| recording : Boolean [唯讀]
Indicates whether recording is taking place. | IAutomationManager | ||
| replaying : Boolean [唯讀]
Indicates whether replay is taking place. | IAutomationManager | ||
隱藏繼承公用方法
顯示繼承公用方法| 方法 | 定義自 | ||
|---|---|---|---|
 | addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
會在 EventDispatcher 物件註冊事件偵聽程式，以便讓偵聽程式收到事件的通知。 | IEventDispatcher | |
Sets the automation manager to record mode. | IAutomationManager | ||
Returns an id for the given object that can be used
with the resolveID() method. | IAutomationManager | ||
Returns an id part for the given object that can be used in the resolveIDPart() method. | IAutomationManager | ||
Decrement the cache counter. | IAutomationManager | ||
|
會將事件傳送到事件流程。 | IEventDispatcher | |
Takes the automation manager out of record mode. | IAutomationManager | ||
Returns the text to display as the type of the object. | IAutomationManager | ||
Returns the text to display as the description for the object. | IAutomationManager | ||
Returns all children of this object that are visible within the testing
hierarchy. | IAutomationManager | ||
getChildrenFromIDPart(obj:IAutomationObject, part:AutomationIDPart = null, ignoreShowInHierarchy:Boolean = false):Array
Returns all children of this object that are visible within the testing
hierarchy and meet the criteria in the automation part. | IAutomationManager | ||
Returns the automation object under the given coordinate. | IAutomationManager | ||
getParent(obj:IAutomationObject, parentToStopAt:IAutomationObject = null, ignoreShowInHierarchy:Boolean = false):IAutomationObject
Returns the next parent that is visible within the automation hierarchy. | IAutomationManager | ||
getProperties(obj:IAutomationObject, names:Array = null, forVerification:Boolean = true, forDescription:Boolean = true):Array
Returns the values for a set of properties. | IAutomationManager | ||
The display rectangle enclosing the DisplayObject. | IAutomationManager | ||
Returns the object implementing the IAutomationTabularData interface through which
the tabular data can be obtained. | IAutomationManager | ||
|
會檢查 EventDispatcher 物件是否有對特定的事件類型註冊偵聽程式。 | IEventDispatcher | |
Increments the cache counter. | IAutomationManager | ||
Tests if the provided target needs to wait until a previous
operation completes. | IAutomationManager | ||
Returns true if an object and all of its parents are visible. | IAutomationManager | ||
Records the event. | IAutomationManager | ||
Records the custom event. | IAutomationManager | ||
|
會從 EventDispatcher 物件移除偵聽程式。 | IEventDispatcher | |
Replays the specified event. | IAutomationManager | ||
Resolves an id to automation objects. | IAutomationManager | ||
Resolves an id part to an Array of automation objects. | IAutomationManager | ||
Resolves an id part to an automation object within the parent. | IAutomationManager | ||
Resolves an id to an automation object. | IAutomationManager | ||
Indicates whether an automation object should be visible within
the hierarchy. | IAutomationManager | ||
|
檢查此 EventDispatcher 物件是否已註冊事件偵聽程式，或者此物件的任何祖系已為特定事件類型註冊事件偵聽程式。 | IEventDispatcher | |
automationEnvironment | 屬性 |
automationEnvironment:Object| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
The automation environment for this automation manager. The automation environment provides information about the objects and properties of testable components needed for communicating with agent tools.
The value of this property must implement the IAutomationEnvironment interface.
實作
public function get automationEnvironment():Object public function set automationEnvironment(value:Object):void相關 API 元素
recording | 屬性 |
replaying | 屬性 |
beginRecording | () | 方法 |
public function beginRecording():void| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
Sets the automation manager to record mode.
createID | () | 方法 |
public function createID(obj:IAutomationObject, relativeToParent:IAutomationObject = null):AutomationID| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
Returns an id for the given object that can be used
with the resolveID() method.
參數
obj:IAutomationObject — Automation object.
| |
relativeToParent:IAutomationObject (default = null) |
AutomationID — AutomationID object which represents the Automation object.
|
createIDPart | () | 方法 |
public function createIDPart(obj:IAutomationObject, parent:IAutomationObject = null):AutomationIDPart| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
Returns an id part for the given object that can be used in the resolveIDPart() method.
參數
obj:IAutomationObject — The automation object.
| |
parent:IAutomationObject (default = null) |
AutomationIDPart — AutomationIDPart object which represents the Automation object.
|
decrementCacheCounter | () | 方法 |
public function decrementCacheCounter(clearNow:Boolean = false):int| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
Decrement the cache counter. The cache is cleared when the count reaches zero.
參數
clearNow:Boolean (default = false)true, clear the cache regardless of the cache counter.
|
int — Current cache counter.
|
endRecording | () | 方法 |
public function endRecording():void| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
Takes the automation manager out of record mode.
getAutomationClassName | () | 方法 |
public function getAutomationClassName(obj:IAutomationObject):String| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
Returns the text to display as the type of the object.
參數
obj:IAutomationObject — Automation object.
|
String — Type of the object.
|
getAutomationName | () | 方法 |
public function getAutomationName(obj:IAutomationObject):String| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
Returns the text to display as the description for the object.
參數
obj:IAutomationObject — Automation object.
|
String — Text description of the Automation object.
|
getChildren | () | 方法 |
public function getChildren(obj:IAutomationObject, ignoreShowInHierarchy:Boolean = false):Array| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
Returns all children of this object that are visible within the testing hierarchy. If a child is not visible within the hierarchy, returns the children of the invisible child.
參數
obj:IAutomationObject — Object for which to get the children.
| |
ignoreShowInHierarchy:Boolean (default = false) |
Array — Array of children.
|
getChildrenFromIDPart | () | 方法 |
public function getChildrenFromIDPart(obj:IAutomationObject, part:AutomationIDPart = null, ignoreShowInHierarchy:Boolean = false):Array| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
Returns all children of this object that are visible within the testing hierarchy and meet the criteria in the automation part. If a child is not visible within the hierarchy, this method returns the children of the invisible child.
參數
obj:IAutomationObject — Object for which to get the children.
| |
part:AutomationIDPart (default = null) | |
ignoreShowInHierarchy:Boolean (default = false)false.
|
Array — Array of children matching the criteria.
|
getElementFromPoint | () | 方法 |
public function getElementFromPoint(x:int, y:int):IAutomationObject| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
Returns the automation object under the given coordinate.
參數
x:int — The x coordinate.
| |
y:int — The y coordinate.
|
IAutomationObject — Automation object at that point.
|
getParent | () | 方法 |
public function getParent(obj:IAutomationObject, parentToStopAt:IAutomationObject = null, ignoreShowInHierarchy:Boolean = false):IAutomationObject| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
Returns the next parent that is visible within the automation hierarchy.
參數
obj:IAutomationObject — Automation object.
| |
parentToStopAt:IAutomationObject (default = null) | |
ignoreShowInHierarchy:Boolean (default = false)false.
|
IAutomationObject — Nearest parent of the object visible within the automation
hierarchy.
|
getProperties | () | 方法 |
public function getProperties(obj:IAutomationObject, names:Array = null, forVerification:Boolean = true, forDescription:Boolean = true):Array| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
Returns the values for a set of properties.
參數
obj:IAutomationObject — Object for which to get the properties.
| |
names:Array (default = null) | |
forVerification:Boolean (default = true)true, only include verification properties.
| |
forDescription:Boolean (default = true)true, only include description properties.
|
Array — Array of objects that contain each property value and descriptor.
|
getRectangle | () | 方法 |
public function getRectangle(obj:DisplayObject):Array| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
The display rectangle enclosing the DisplayObject.
參數
obj:DisplayObject — DisplayObject whose rectangle is desired.
|
Array — An array of four integers: top, left, width and height.
|
getTabularData | () | 方法 |
public function getTabularData(obj:IAutomationObject):mx.automation:IAutomationTabularData| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
Returns the object implementing the IAutomationTabularData interface through which the tabular data can be obtained.
參數
obj:IAutomationObject — An IAutomationObject.
|
mx.automation:IAutomationTabularData — An object implementing the IAutomationTabularData interface.
|
incrementCacheCounter | () | 方法 |
public function incrementCacheCounter():int| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
Increments the cache counter. The automation mechanism
caches both an object's properties and its children. The cache
exists for both performance reasons, and so that an objects state
prior to a recording can be captured. Each call to the
incrementCacheCounter() method
increments a counter and each call to the
decrementCacheCounter() method
decrements the cache counter. When the counter reaches zero the
cache is cleared.
It's important that testing tools only use the
cache when they are certain that the state of the Flex application
is frozen and the user cannot interact with it. For example,
when an automation event is recorded, a testing tool might need to make
several calls to the getChildren() method or the
getProperties() method to create a testing
script line. To do this, it would wrap all the calls up in
start/stop cache calls.
Internally, the AutomationManager forcibly clears the cache
before an end-user interaction that might trigger an automation
event. It then increments the cache counter and decrements the
counter after the automation event is dispatched. Testing tools can
prevent the count from reaching zero by calling the incrementCacheCounter()
method in their record handler.
int — the current cache counter.
|
isSynchronized | () | 方法 |
public function isSynchronized(target:IAutomationObject):Boolean| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
Tests if the provided target needs to wait until a previous operation completes.
參數
target:IAutomationObject — Target to check for synchronization or
null to synchronize on any running operations.
|
Boolean — true if synchronization is complete, false otherwise.
|
isVisible | () | 方法 |
public function isVisible(obj:DisplayObject):Boolean| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
Returns true if an object and all of its parents are visible.
參數
obj:DisplayObject — DisplayObject.
|
Boolean — true if an object and all of its parents are visible.
|
recordAutomatableEvent | () | 方法 |
public function recordAutomatableEvent(recorder:IAutomationObject, event:Event, cacheable:Boolean = false):void| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
Records the event.
參數
recorder:IAutomationObject — The automation object on which the event is to be recorded.
| |
event:Event — The actual event which needs to be recorded.
| |
cacheable:Boolean (default = false)click event for the button, but ignores the select event
generated from the List control.
|
recordCustomAutomationEvent | () | 方法 |
public function recordCustomAutomationEvent(customEvent:AutomationRecordEvent):Boolean| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
Records the custom event.
參數
customEvent:AutomationRecordEvent — - The AutomationRecordEvent that specifies that it is a custom evnet; the type is customRecord.
For example, if you want to record a custom event without writing a delegate and providing the details
in an environment file, you can use this interface to record the custom event. You should listen to
the AutomationPlaybackEvent, handle the replay, and prevent the default on the AutomationPlaybackEvent.
|
Boolean |
replayAutomatableEvent | () | 方法 |
public function replayAutomatableEvent(event:AutomationReplayEvent):Boolean| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
Replays the specified event. A component author should call
the super.replayAutomatableEvent() method
in case default replay behavior has been defined in a superclass.
參數
event:AutomationReplayEvent — Event to replay.
|
Boolean — true if the replay was successful.
|
resolveID | () | 方法 |
public function resolveID(rid:AutomationID, currentParent:IAutomationObject = null):Array| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
Resolves an id to automation objects.
參數
rid:AutomationID — Automation id of the automation object.
| |
currentParent:IAutomationObject (default = null) |
Array — An Array containing all the objects matching the rid.
|
resolveIDPart | () | 方法 |
public function resolveIDPart(parent:IAutomationObject, part:AutomationIDPart):Array| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
Resolves an id part to an Array of automation objects.
參數
parent:IAutomationObject — Parent of the automation object.
| |
part:AutomationIDPart — id part of the automation object.
|
Array — Array of automation objects which match part.
|
resolveIDPartToSingleObject | () | 方法 |
public function resolveIDPartToSingleObject(parent:IAutomationObject, part:AutomationIDPart):IAutomationObject| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
Resolves an id part to an automation object within the parent.
參數
parent:IAutomationObject — Parent of the automation object.
| |
part:AutomationIDPart — id part of the automation object.
|
IAutomationObject — IAutomationObject which matches with the part.
If no object
is found or multiple objects are found, throw an exception.
|
resolveIDToSingleObject | () | 方法 |
public function resolveIDToSingleObject(rid:AutomationID, currentParent:IAutomationObject = null):IAutomationObject| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
Resolves an id to an automation object.
參數
rid:AutomationID — Automation id of the automation object.
| |
currentParent:IAutomationObject (default = null) |
IAutomationObject — IAutomationObject which matches with the rid.
If no object
is found or multiple objects are found, this method throws an exception.
|
showInHierarchy | () | 方法 |
public function showInHierarchy(obj:IAutomationObject):Boolean| 語言版本: | ActionScript 3.0 |
| 產品版本: | Flex 3 |
| 執行階段版本: | Flash Player 9, AIR 1.1 |
Indicates whether an automation object should be visible within the hierarchy.
參數
obj:IAutomationObject — The automation object.
|
Boolean — true if the object should be shown within the
automation hierarchy.
|
Tue Jun 12 2018, 03:47 PM Z