| 包 | mx.automation |
| 接口 | public interface IAutomationManager extends IEventDispatcher |
| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
公共属性
| 属性 | 由以下参数定义 | ||
|---|---|---|---|
| automationEnvironment : Object
此自动化管理器的自动化环境。 | IAutomationManager | ||
| recording : Boolean [只读]
指示是否已进行录制。 | IAutomationManager | ||
| replaying : Boolean [只读]
指示是否已进行重放。 | IAutomationManager | ||
公共方法
隐藏继承的公共方法
显示继承的公共方法| 方法 | 由以下参数定义 | ||
|---|---|---|---|
 | addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
使用 EventDispatcher 对象注册事件侦听器对象，以使侦听器能够接收事件通知。 | IEventDispatcher | |
将自动化管理器设置为录制模式。 | IAutomationManager | ||
返回可与 resolveID() 方法一起使用的给定对象的 ID。 | IAutomationManager | ||
返回可在 resolveIDPart() 方法中使用的给定对象的 ID 部分。 | IAutomationManager | ||
减少缓存计数器计数。 | IAutomationManager | ||
|
将事件调度到事件流中。 | IEventDispatcher | |
使自动化管理器进入取消录制模式。 | IAutomationManager | ||
返回将显示为对象类型的文本。 | IAutomationManager | ||
返回将显示为对象说明的文本。 | IAutomationManager | ||
返回此对象的所有在测试层次中可见的子项。 | IAutomationManager | ||
getChildrenFromIDPart(obj:IAutomationObject, part:AutomationIDPart = null, ignoreShowInHierarchy:Boolean = false):Array
返回此对象的所有在测试层次中可见并符合自动化部分中条件的子项。 | IAutomationManager | ||
返回给定坐标下的自动化对象。 | IAutomationManager | ||
getParent(obj:IAutomationObject, parentToStopAt:IAutomationObject = null, ignoreShowInHierarchy:Boolean = false):IAutomationObject
返回下一个在自动化层次中可见的父项。 | IAutomationManager | ||
getProperties(obj:IAutomationObject, names:Array = null, forVerification:Boolean = true, forDescription:Boolean = true):Array
返回一组属性的值。 | IAutomationManager | ||
将 DisplayObject 围起来的显示矩形。 | IAutomationManager | ||
返回实现 IAutomationTabularData 接口的对象，通过此接口可以获得表格数据。 | IAutomationManager | ||
|
检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。 | IEventDispatcher | |
增加缓存计数器计数。 | IAutomationManager | ||
如果提供的目标需要等到上一操作完成，则进行测试。 | IAutomationManager | ||
如果某个对象及其所有父项都可见，则返回 ture。 | IAutomationManager | ||
录制事件。 | IAutomationManager | ||
记录自定义事件。 | IAutomationManager | ||
|
从 EventDispatcher 对象中删除侦听器。 | IEventDispatcher | |
重放指定的事件。 | IAutomationManager | ||
解析针对多个自动化对象的某个 ID。 | IAutomationManager | ||
将 ID 部分解析为自动化对象的 Array。 | IAutomationManager | ||
将 ID 部分解析为父项中的自动化对象。 | IAutomationManager | ||
解析某个自动化对象的 ID。 | IAutomationManager | ||
指示自动化对象是否应在层次中可见。 | IAutomationManager | ||
|
检查是否用此 EventDispatcher 对象或其任何祖代为指定事件类型注册了事件侦听器。 | IEventDispatcher | |
属性详细信息
automationEnvironment | 属性 |
automationEnvironment:Object| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
此自动化管理器的自动化环境。自动化环境提供了有关与代理工具进行通信所需的可测试组件的对象和属性的信息。
此属性的值必须实现 IAutomationEnvironment 接口。
实现
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 |
将自动化管理器设置为录制模式。
createID | () | 方法 |
public function createID(obj:IAutomationObject, relativeToParent:IAutomationObject = null):AutomationID| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
返回可与 resolveID() 方法一起使用的给定对象的 ID。
参数
obj:IAutomationObject — 自动化对象。
| |
relativeToParent:IAutomationObject (default = null) |
AutomationID — 表示自动化对象的 AutomationID 对象。
|
createIDPart | () | 方法 |
public function createIDPart(obj:IAutomationObject, parent:IAutomationObject = null):AutomationIDPart| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
返回可在 resolveIDPart() 方法中使用的给定对象的 ID 部分。
参数
obj:IAutomationObject — 自动化对象。
| |
parent:IAutomationObject (default = null) |
AutomationIDPart — 表示自动化对象的 AutomationIDPart 对象。
|
decrementCacheCounter | () | 方法 |
endRecording | () | 方法 |
public function endRecording():void| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
使自动化管理器进入取消录制模式。
getAutomationClassName | () | 方法 |
public function getAutomationClassName(obj:IAutomationObject):String| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
返回将显示为对象类型的文本。
参数
obj:IAutomationObject — 自动化对象。
|
String — 对象的类型。
|
getAutomationName | () | 方法 |
public function getAutomationName(obj:IAutomationObject):String| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
返回将显示为对象说明的文本。
参数
obj:IAutomationObject — 自动化对象。
|
String — 自动化对象的文本说明。
|
getChildren | () | 方法 |
public function getChildren(obj:IAutomationObject, ignoreShowInHierarchy:Boolean = false):Array| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
返回此对象的所有在测试层次中可见的子项。如果某个子项在层次中不可见，则将返回不可见子项的子项。
参数
obj:IAutomationObject — 为其获取子项的对象。
| |
ignoreShowInHierarchy:Boolean (default = false) |
Array — 子项的数组。
|
getChildrenFromIDPart | () | 方法 |
public function getChildrenFromIDPart(obj:IAutomationObject, part:AutomationIDPart = null, ignoreShowInHierarchy:Boolean = false):Array| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
返回此对象的所有在测试层次中可见并符合自动化部分中条件的子项。如果某个子项在层次中不可见，则此方法将返回不可见子项的子项。
参数
obj:IAutomationObject — 为其获取子项的对象。
| |
part:AutomationIDPart (default = null) | |
ignoreShowInHierarchy:Boolean (default = false)false。
|
Array — 符合条件的子项的数组。
|
getElementFromPoint | () | 方法 |
public function getElementFromPoint(x:int, y:int):IAutomationObject| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
返回给定坐标下的自动化对象。
参数
x:int — x 坐标。
| |
y:int — y 坐标。
|
IAutomationObject — 该点处的自动化对象。
|
getParent | () | 方法 |
public function getParent(obj:IAutomationObject, parentToStopAt:IAutomationObject = null, ignoreShowInHierarchy:Boolean = false):IAutomationObject| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
返回下一个在自动化层次中可见的父项。
参数
obj:IAutomationObject — 自动化对象。
| |
parentToStopAt:IAutomationObject (default = null) | |
ignoreShowInHierarchy:Boolean (default = false)false。
|
IAutomationObject — 自动化层次中可见对象的最近父项。
|
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 |
返回一组属性的值。
参数
obj:IAutomationObject — 为其获取属性的对象。
| |
names:Array (default = null) | |
forVerification:Boolean (default = true)true，则仅包含验证属性。
| |
forDescription:Boolean (default = true)true，则仅包含描述属性。
|
Array — 包含各个属性值及描述符的对象数组。
|
getRectangle | () | 方法 |
public function getRectangle(obj:DisplayObject):Array| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
将 DisplayObject 围起来的显示矩形。
参数
obj:DisplayObject — 具有所需矩形的 DisplayObject。
|
Array — 包含四个整数的数组：上边界、左边界、宽度和高度。
|
getTabularData | () | 方法 |
public function getTabularData(obj:IAutomationObject):mx.automation:IAutomationTabularData| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
返回实现 IAutomationTabularData 接口的对象，通过此接口可以获得表格数据。
参数
obj:IAutomationObject — IAutomationObject。
|
mx.automation:IAutomationTabularData — 实现 IAutomationTabularData 接口的对象。
|
incrementCacheCounter | () | 方法 |
public function incrementCacheCounter():int| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
增加缓存计数器计数。自动化机制会缓存对象的属性及其子项。出于性能原因使用缓存，以便在录制之前捕获对象状态。每次调用 incrementCacheCounter() 方法都会增加计数器计数，而每次调用 decrementCacheCounter() 方法都会减少缓存计数器计数。计数器达到零时，将清除缓存。
仅当确定 Flex 应用程序处于冻结状态且用户无法与之交互时，测试工具才能使用缓存，这一点很重要。例如，记录自动化事件时，测试工具可能需要多次调用 getChildren() 方法或 getProperties() 方法以创建测试脚本行。为此，它会在开始/停止缓存调用中完成所有调用。
在最终用户交互可能触发自动化事件之前，AutomationManager 会在内部强制清除缓存，然后它增加缓存计数器计数，并在调度自动化事件后减少计数器计数。测试工具可通过调用其录制处理函数中的 incrementCacheCounter() 方法来阻止计数达到零。
int — 当前缓存计数器。
|
isSynchronized | () | 方法 |
public function isSynchronized(target:IAutomationObject):Boolean| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
如果提供的目标需要等到上一操作完成，则进行测试。
参数
target:IAutomationObject — 目标是检查同步；或者设为 null 以同步任何运行的操作。
|
Boolean — 如果同步完成，则为 true，否则为 false。
|
isVisible | () | 方法 |
public function isVisible(obj:DisplayObject):Boolean| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
如果某个对象及其所有父项都可见，则返回 true。
参数
obj:DisplayObject — DisplayObject。
|
Boolean — 如果某个对象及其所有父项都可见，则返回 true。
|
recordAutomatableEvent | () | 方法 |
public function recordAutomatableEvent(recorder:IAutomationObject, event:Event, cacheable:Boolean = false):void| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
录制事件。
参数
recorder:IAutomationObject — 在其上录制事件的自动化对象。
| |
event:Event — 需要录制的实际事件。
| |
cacheable:Boolean (default = false)click 事件，而忽略从 List 控件生成的 select 事件。
|
recordCustomAutomationEvent | () | 方法 |
public function recordCustomAutomationEvent(customEvent:AutomationRecordEvent):Boolean| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
记录自定义事件。
参数
customEvent:AutomationRecordEvent — - 指定事件是自定义事件的 AutomationRecordEvent；它属于 customRecord 类型。例如，如果希望在录制自定义事件时不在环境文件中写入委托和提供详细信息，则可以使用此接口录制自定义事件。应侦听 AutomationPlaybackEvent、处理重放以及避免针对 AutomationPlaybackEvent 发生的默认行为。
|
Boolean |
replayAutomatableEvent | () | 方法 |
public function replayAutomatableEvent(event:AutomationReplayEvent):Boolean| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
重放指定的事件。如果已在 superclass 中定义默认重放行为，组件作者应调用 super.replayAutomatableEvent() 方法。
参数
event:AutomationReplayEvent — 要重放的事件。
|
Boolean — 如果重放成功，则为 true。
|
resolveID | () | 方法 |
public function resolveID(rid:AutomationID, currentParent:IAutomationObject = null):Array| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
解析针对多个自动化对象的某个 ID。
参数
rid:AutomationID — 自动化对象的自动化 ID。
| |
currentParent:IAutomationObject (default = null) |
Array — 包含与 rid 匹配的所有对象的 Array。
|
resolveIDPart | () | 方法 |
public function resolveIDPart(parent:IAutomationObject, part:AutomationIDPart):Array| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
将 ID 部分解析为自动化对象的 Array。
参数
parent:IAutomationObject — 自动化对象的父项。
| |
part:AutomationIDPart — 自动化对象的 ID 部分。
|
Array — 与 part 匹配的自动化对象的数组。
|
resolveIDPartToSingleObject | () | 方法 |
public function resolveIDPartToSingleObject(parent:IAutomationObject, part:AutomationIDPart):IAutomationObject| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
将 ID 部分解析为父项中的自动化对象。
参数
parent:IAutomationObject — 自动化对象的父项。
| |
part:AutomationIDPart — 自动化对象的 ID 部分。
|
IAutomationObject — 与 part 匹配的 IAutomationObject。如果找不到对象或找到多个对象，则会引发异常。
|
resolveIDToSingleObject | () | 方法 |
public function resolveIDToSingleObject(rid:AutomationID, currentParent:IAutomationObject = null):IAutomationObject| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
解析某个自动化对象的 ID。
参数
rid:AutomationID — 自动化对象的自动化 ID。
| |
currentParent:IAutomationObject (default = null) |
IAutomationObject — 与 rid 匹配的 IAutomationObject。如果找不到对象或找到多个对象，此方法将引发异常。
|
showInHierarchy | () | 方法 |
public function showInHierarchy(obj:IAutomationObject):Boolean| 语言版本: | ActionScript 3.0 |
| 产品版本: | Flex 3 |
| 运行时版本: | Flash Player 9, AIR 1.1 |
指示自动化对象是否应在层次中可见。
参数
obj:IAutomationObject — 自动化对象。
|
Boolean — 如果该对象应显示在自动化层次中，则为 true。
|
Tue Jun 12 2018, 11:04 AM Z