IAutomationManager2 - Adobe ActionScript® 3 (AS3 Flex) API 参考

包	mx.automation
接口	public interface IAutomationManager2 extends IAutomationManager , IEventDispatcher
实现器	AutomationManager

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 9, AIR 1.1

IAutomationManager 接口定义自动化模块希望从 AutomationManager 对象获得的接口。

公共属性

隐藏继承的公共属性

显示继承的公共属性

	属性		由以下参数定义
		automationEnvironment : Object 此自动化管理器的自动化环境。	IAutomationManager
		automationEnvironmentHandlingClassName : String [只写] 封送支持（对于工具）：负责处理自动化环境的工具类。	IAutomationManager2
		automationEnvironmentString : String [只写] 此自动化管理器的自动化环境。	IAutomationManager2
		recording : Boolean [只读] 指示是否已进行录制。	IAutomationManager
		replaying : Boolean [只读] 指示是否已进行重放。	IAutomationManager

公共方法

隐藏继承的公共方法

显示继承的公共方法

	方法		由以下参数定义
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void 使用 EventDispatcher 对象注册事件侦听器对象，以使侦听器能够接收事件通知。	IEventDispatcher
		addEventListenersToAllChildApplications(eventDetailsArray:Array):void 封送支持（对于工具）：将传入 EventDetails 对象添加到当前 ApplicationDomain 中的可能子应用程序。	IAutomationManager2
		addEventListenersToAllParentApplications(eventDetailsArray:Array):void 封送支持（对于工具）：将传入 EventDetails 对象添加到当前 ApplicationDomain 中的可能父应用程序。	IAutomationManager2
		beginRecording():void 将自动化管理器设置为录制模式。	IAutomationManager
		createID(obj:IAutomationObject, relativeToParent:IAutomationObject = null):AutomationID 返回可与 resolveID() 方法一起使用的给定对象的 ID。	IAutomationManager
		createIDPart(obj:IAutomationObject, parent:IAutomationObject = null):AutomationIDPart 返回可在 resolveIDPart() 方法中使用的给定对象的 ID 部分。	IAutomationManager
		decrementCacheCounter(clearNow:Boolean = false):int 减少缓存计数器计数。	IAutomationManager
		dispatchEvent(event:Event):Boolean 将事件调度到事件流中。	IEventDispatcher
		dispatchToAllChildren(event:Event):void 封送支持（对于工具）：将事件调度给所有子代。	IAutomationManager2
		dispatchToParent(event:Event):void 封送支持（对于工具）：将事件调度给父应用程序。	IAutomationManager2
		endRecording():void 使自动化管理器进入取消录制模式。	IAutomationManager
		getAIRWindow(windowId:String):DisplayObject AIR 支持（对于工具）：返回具有传入 ID 的窗口。	IAutomationManager2
		getAIRWindowUniqueID(newWindow:DisplayObject):String AIR 支持（对于工具）：返回窗口对象的唯一 ID。	IAutomationManager2
		getAIRWindowUniqueIDFromAutomationIDPart(objectIdPart:AutomationIDPart):String AIR 支持（对于工具）：从自动化 ID 部分返回窗口的唯一 ID。	IAutomationManager2
		getAIRWindowUniqueIDFromObjectIDString(objectId:String):String AIR 支持（对于工具）：从对象 ID 返回窗口的唯一 ID。	IAutomationManager2
		getApplicationNameFromAutomationIDPart(objectID:AutomationIDPart):String 封送支持（对于工具）：从部分 ID 返回应用程序的名称。	IAutomationManager2
		getAutomationClassName(obj:IAutomationObject):String 返回将显示为对象类型的文本。	IAutomationManager
		getAutomationName(obj:IAutomationObject):String 返回将显示为对象说明的文本。	IAutomationManager
		getChildren(obj:IAutomationObject, ignoreShowInHierarchy:Boolean = false):Array 返回此对象的所有在测试层次中可见的子项。	IAutomationManager
		getChildrenFromIDPart(obj:IAutomationObject, part:AutomationIDPart = null, ignoreShowInHierarchy:Boolean = false):Array 返回此对象的所有在测试层次中可见并符合自动化部分中条件的子项。	IAutomationManager
		getElementFromPoint(x:int, y:int):IAutomationObject 返回给定坐标下的自动化对象。	IAutomationManager
		getElementFromPoint2(x:int, y:int, windowId:String):IAutomationObject AIR 支持（对于工具）：返回窗口中位于给定坐标下的自动化对象。	IAutomationManager2
		getParent(obj:IAutomationObject, parentToStopAt:IAutomationObject = null, ignoreShowInHierarchy:Boolean = false):IAutomationObject 返回下一个在自动化层次中可见的父项。	IAutomationManager
		getPopUpChildObject(index:int):IAutomationObject 封送支持（对于委托）：返回根应用程序的弹出对象的数组。	IAutomationManager2
		getPopUpChildren():Array 封送支持（对于委托）：返回顶级应用程序的弹出对象的数组。	IAutomationManager2
		getPopUpChildrenCount():Number 封送支持（对于委托）：返回顶级应用程序的弹出子代的数量。	IAutomationManager2
		getProperties(obj:IAutomationObject, names:Array = null, forVerification:Boolean = true, forDescription:Boolean = true):Array 返回一组属性的值。	IAutomationManager
		getRectangle(obj:DisplayObject):Array 将 DisplayObject 围起来的显示矩形。	IAutomationManager
		getStartPointInScreenCoordinates(windowId:String):Point AIR 支持（对于工具）：由从 AIR 应用程序加载的 Flex 应用程序使用，用于获取主 AIR 应用程序的起点（以屏幕坐标表示）	IAutomationManager2
		getTabularData(obj:IAutomationObject):mx.automation:IAutomationTabularData 返回实现 IAutomationTabularData 接口的对象，通过此接口可以获得表格数据。	IAutomationManager
		getTopApplicationIndex(objectList:Array):int 封送支持（对于工具）：返回传入对象数组中顶部可见对象的索引。	IAutomationManager2
		getUniqueApplicationID():String 封送支持（对于工具）：就使用 SWFLoader 信息和应用程序名称的层次结构而言，返回应用程序的唯一 ID。	IAutomationManager2
		hasEventListener(type:String):Boolean 检查 EventDispatcher 对象是否为特定事件类型注册了任何侦听器。	IEventDispatcher
		incrementCacheCounter():int 增加缓存计数器计数。	IAutomationManager
		isObjectPopUp(obj:IAutomationObject):Boolean 封送支持（对于工具）：如果传入对象为弹出对象，则返回 true。	IAutomationManager2
		isSynchronized(target:IAutomationObject):Boolean 如果提供的目标需要等到上一操作完成，则进行测试。	IAutomationManager
		isVisible(obj:DisplayObject):Boolean 如果某个对象及其所有父项都可见，则返回 ture。	IAutomationManager
		recordAutomatableEvent(recorder:IAutomationObject, event:Event, cacheable:Boolean = false):void 录制事件。	IAutomationManager
		recordCustomAutomationEvent(customEvent:AutomationRecordEvent):Boolean 记录自定义事件。	IAutomationManager
		registerNewApplication(application:DisplayObject):void 封送支持（对于委托）：在添加新应用程序时，应用程序委托会注册自身，以便向该应用程序添加适当的侦听器来支持封送。	IAutomationManager2
		registerNewFlexNativeMenu(menu:Object, sm:DisplayObject):void AIR 支持（对于委托）：在将 FlexNativeMenu 添加到组件时，组件委托会注册新的 FlexNativeMenu 对象并创建一个委托。	IAutomationManager2
		registerNewWindow(newWindow:DisplayObject):void AIR 支持（对于委托）：在添加新窗口时，WindowedApplication 委托会注册新窗口对象，以便为该窗口创建唯一 ID。	IAutomationManager2
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void 从 EventDispatcher 对象中删除侦听器。	IEventDispatcher
		replayAutomatableEvent(event:AutomationReplayEvent):Boolean 重放指定的事件。	IAutomationManager
		resolveID(rid:AutomationID, currentParent:IAutomationObject = null):Array 解析针对多个自动化对象的某个 ID。	IAutomationManager
		resolveIDPart(parent:IAutomationObject, part:AutomationIDPart):Array 将 ID 部分解析为自动化对象的 Array。	IAutomationManager
		resolveIDPartToSingleObject(parent:IAutomationObject, part:AutomationIDPart):IAutomationObject 将 ID 部分解析为父项中的自动化对象。	IAutomationManager
		resolveIDToSingleObject(rid:AutomationID, currentParent:IAutomationObject = null):IAutomationObject 解析某个自动化对象的 ID。	IAutomationManager
		showInHierarchy(obj:IAutomationObject):Boolean 指示自动化对象是否应在层次中可见。	IAutomationManager
		storeDragProxy(dragProxy:Object):void 封送支持（对于委托）：存储拖动代理，以便一个应用程序在需要时可以访问在另一个应用程序中创建的应用程序间 drag-drop.DragProxy。	IAutomationManager2
		willTrigger(type:String):Boolean 检查是否用此 EventDispatcher 对象或其任何祖代为指定事件类型注册了事件侦听器。	IEventDispatcher

属性详细信息

automationEnvironmentHandlingClassName

属性

automationEnvironmentHandlingClassName:String [只写]

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 9, AIR 1.1

封送支持（对于工具）：负责处理自动化环境的工具类。

实现
public function set automationEnvironmentHandlingClassName(value:String):void

automationEnvironmentString

属性

automationEnvironmentString:String [只写]

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 9, AIR 1.1

此自动化管理器的自动化环境。自动化环境提供了有关与代理工具进行通信所需的可测试组件的对象和属性的信息。此属性的值必须实现 IAutomationEnvironment 接口。

实现
public function set automationEnvironmentString(value:String):void

addEventListenersToAllChildApplications

()

方法

public function addEventListenersToAllChildApplications(eventDetailsArray:Array):void

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 9, AIR 1.1

封送支持（对于工具）：将传入 EventDetails 对象添加到当前 ApplicationDomain 中的可能子应用程序。AutomationManager 标识当前 ApplicationDomain 中的子应用程序，并在加载该应用程序时添加从传入对象中获取的适当侦听器。

参数

eventDetailsArray:Array — EventDetails 对象的数组。

addEventListenersToAllParentApplications

()

方法

public function addEventListenersToAllParentApplications(eventDetailsArray:Array):void

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 9, AIR 1.1

封送支持（对于工具）：将传入 EventDetails 对象添加到当前 ApplicationDomain 中的可能父应用程序。AutomationManager 标识当前 ApplicationDomain 中负责侦听来自子代的事件的父应用程序，并添加从传入对象中获取的适当侦听器。

参数

eventDetailsArray:Array — EventDetails 对象的数组。

dispatchToAllChildren

()

方法

public function dispatchToAllChildren(event:Event):void

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 9, AIR 1.1

封送支持（对于工具）：将事件调度给所有子代。

参数

event:Event — 要调度的事件。

dispatchToParent

()

方法

public function dispatchToParent(event:Event):void

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 9, AIR 1.1

封送支持（对于工具）：将事件调度给父应用程序。

参数

event:Event — 要调度的事件。

getAIRWindow

()

方法

public function getAIRWindow(windowId:String):DisplayObject

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 9, AIR 1.1

AIR 支持（对于工具）：返回具有传入 ID 的窗口。

参数

windowId:String — 窗口的 ID

DisplayObject — 具有传入 ID 的窗口。

getAIRWindowUniqueID

()

方法

public function getAIRWindowUniqueID(newWindow:DisplayObject):String

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 9, AIR 1.1

AIR 支持（对于工具）：返回窗口对象的唯一 ID。

参数

newWindow:DisplayObject — 需要其 ID 的窗口。

String — 字符串

getAIRWindowUniqueIDFromAutomationIDPart

()

方法

public function getAIRWindowUniqueIDFromAutomationIDPart(objectIdPart:AutomationIDPart):String

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 9, AIR 1.1

AIR 支持（对于工具）：从自动化 ID 部分返回窗口的唯一 ID。自动化 ID 部分包含应用程序 ID 和窗口 ID。

参数

objectIdPart:AutomationIDPart — 要从中获取窗口唯一 ID 的 AutomationIDPart。

String

getAIRWindowUniqueIDFromObjectIDString

()

方法

public function getAIRWindowUniqueIDFromObjectIDString(objectId:String):String

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 9, AIR 1.1

AIR 支持（对于工具）：从对象 ID 返回窗口的唯一 ID。对象 ID 包含应用程序 ID 和窗口 ID。

参数

objectId:String — 要从中获取窗口唯一 ID 的对象 ID。

String

getApplicationNameFromAutomationIDPart

()

方法

public function getApplicationNameFromAutomationIDPart(objectID:AutomationIDPart):String

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 9, AIR 1.1

封送支持（对于工具）：从部分 ID 返回应用程序的名称。

参数

objectID:AutomationIDPart — 要从中获取应用程序名称的 AutomationIDPart。

String

getElementFromPoint2

()

方法

public function getElementFromPoint2(x:int, y:int, windowId:String):IAutomationObject

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 9, AIR 1.1

AIR 支持（对于工具）：返回窗口中位于给定坐标下的自动化对象。

参数

	`x:int` — x 坐标。

	`y:int` — y 坐标。

	`windowId:String` — 要标识的对象所在的窗口。

IAutomationObject — 该点处的自动化对象。

getPopUpChildObject

()

方法

public function getPopUpChildObject(index:int):IAutomationObject

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 9, AIR 1.1

封送支持（对于委托）：返回根应用程序的弹出对象的数组。在应用程序中创建的所有弹出对象都将作为弹出子代添加到 ApplicationDomain 的顶级应用程序中。

参数

index:int — 对象的检索位置

IAutomationObject — 给定索引处的 IAutomationObject

getPopUpChildren

()

方法

public function getPopUpChildren():Array

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 9, AIR 1.1

封送支持（对于委托）：返回顶级应用程序的弹出对象的数组。在应用程序中创建的所有弹出对象都将作为弹出子代添加到 ApplicationDomain 的顶级应用程序中。

Array — 弹出子代的数组

getPopUpChildrenCount

()

方法

public function getPopUpChildrenCount():Number

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 9, AIR 1.1

封送支持（对于委托）：返回顶级应用程序的弹出子代的数量。在应用程序中创建的所有弹出对象都将作为弹出子代添加到 ApplicationDomain 的顶级应用程序中。

Number — 弹出子代的数量

getStartPointInScreenCoordinates

()

方法

public function getStartPointInScreenCoordinates(windowId:String):Point

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 9, AIR 1.1

AIR 支持（对于工具）：由从 AIR 应用程序加载的 Flex 应用程序使用，用于获取主 AIR 应用程序的起点（以屏幕坐标表示）

参数

windowId:String

Point

getTopApplicationIndex

()

方法

public function getTopApplicationIndex(objectList:Array):int

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 9, AIR 1.1

封送支持（对于工具）：返回传入对象数组中顶部可见对象的索引。如果鼠标下有多个对象来自不同应用程序，并且这些应用程序属于不同的 ApplicationDomain 或 SecurityDomain，则工具可以使用此方法来标识最顶端的应用程序对象。

参数

objectList:Array — 对象数组

int

getUniqueApplicationID

()

方法

public function getUniqueApplicationID():String

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 9, AIR 1.1

封送支持（对于工具）：就使用 SWFLoader 信息和应用程序名称的层次结构而言，返回应用程序的唯一 ID。

String

isObjectPopUp

()

方法

public function isObjectPopUp(obj:IAutomationObject):Boolean

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 9, AIR 1.1

封送支持（对于工具）：如果传入对象为弹出对象，则返回 true。

参数

obj:IAutomationObject — IAutomationObject

Boolean

registerNewApplication

()

方法

public function registerNewApplication(application:DisplayObject):void

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 9, AIR 1.1

封送支持（对于委托）：在添加新应用程序时，应用程序委托会注册自身，以便向该应用程序添加适当的侦听器来支持封送。

参数

application:DisplayObject — 要注册的应用程序对象。

registerNewFlexNativeMenu

()

方法

public function registerNewFlexNativeMenu(menu:Object, sm:DisplayObject):void

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 9, AIR 1.1

AIR 支持（对于委托）：在将 FlexNativeMenu 添加到组件时，组件委托会注册新的 FlexNativeMenu 对象并创建一个委托。

参数

	`menu:Object` — 要注册的 FlexNativeMenu 对象。

	`sm:DisplayObject` — 要向其中添加 FlexNativeMenu 的组件的 SystemManager。

registerNewWindow

()

方法

public function registerNewWindow(newWindow:DisplayObject):void

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 9, AIR 1.1

AIR 支持（对于委托）：在添加新窗口时，WindowedApplication 委托会注册新窗口对象，以便为该窗口创建唯一 ID。

参数

newWindow:DisplayObject — 要注册的窗口对象。

storeDragProxy

()

方法

public function storeDragProxy(dragProxy:Object):void

语言版本:

ActionScript 3.0

产品版本:

Flex 4

运行时版本:

Flash Player 9, AIR 1.1

封送支持（对于委托）：存储拖动代理，以便一个应用程序在需要时可以访问在另一个应用程序中创建的应用程序间 drag-drop.DragProxy。

参数

dragProxy:Object — 对象

法律声明 | 在线隐私策略

IAutomationManager2 - AS3 Flex

类 x

automationEnvironmentHandlingClassName

automationEnvironmentString

addEventListenersToAllChildApplications

addEventListenersToAllParentApplications

dispatchToAllChildren

dispatchToParent

getAIRWindow

getAIRWindowUniqueID

getAIRWindowUniqueIDFromAutomationIDPart

getAIRWindowUniqueIDFromObjectIDString

getApplicationNameFromAutomationIDPart

getElementFromPoint2

getPopUpChildObject

getPopUpChildren

getPopUpChildrenCount

getStartPointInScreenCoordinates

getTopApplicationIndex

getUniqueApplicationID

isObjectPopUp

registerNewApplication

registerNewFlexNativeMenu

registerNewWindow

storeDragProxy