AutomationID

包	mx.automation
类	public class AutomationID
继承	AutomationID Object

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

Flex 自动化框架使用 AutomationID 类构建代理可使用的对象标识。AutomationID 包含许多 AutomationIDPart，其中每部分都标识层次中的一个对象。AutomationID 定义映射 Array 的序列化格式。此类用于表示一种层次，该层次使用段来描述其中每个对象的属性。ID 的序列化格式为：

property_1_name{property_1_value property_1_type}property_2_name{property_2_value property_2_type}|property_1_name{property_1_value property_1_type}property_2_name{property_2_value property_2_type}

请考虑一个具有以下层次的 Flex 应用程序：

Application -- > Accordion -- > HBox -- > Button

该按钮的 AutomationID 包含四个 AutomationIDPart，分别用于应用程序、Accordion、HBox 和 Button。AutomationIDPart 是一个包含属性名称及属性值的表格。不同对象类型的属性值对也不同。这些属性值对应该可用于唯一地标识对象。

AutomationID 是通过浏览叶子对象的父层次并为遇到的每个对象创建 AutomationIDPart 创建的。将跳过 showInAutomationHierarchy 已设为 false 的父项。此类父项的子项被视为下一个更高级父项的子项，这个更高级父项的 showInAuto 标志设置为 true。在录制过程中，此 AutomationID 可由代理保存。

在重放过程中，如果代理提供 AutomationID 来查找对象，则从顶层应用程序对象向下浏览显示对象层次。在每个级别，都会从所有子项列表中拾取与 AutomationIDPart 最为匹配的子项。如果有多个子项符合条件，则会引发错误。用户有责任提供唯一的 automationName 或者标识使对象唯一的对象的新属性，以解决此冲突。

如果希望具有永久性，代理可以保存此对象信息。AutomationID 提供了 toString() 和 parse() 方法，用于将对象转换为字符串表示形式以及将字符串表示形式转换为对象。

可使用 IAutomationManager.createAutomationID() 和 IAutomationManager.resolveAutomationID() 方法分别创建和解析 AutomationID 对象。

可使用 IAutomationObjectHelper.helpCreateIDPart() 和 IAutomationObjectHelper.helpResolveIDPart() 方法标识父项中与 AutomationIDPart 匹配的子项。

公共属性

隐藏继承的公共属性

显示继承的公共属性

	属性		由以下参数定义
		constructor : Object 对类对象或给定对象实例的构造函数的引用。	Object
		length : int [只读] 此 ID 中的部分数。	AutomationID

公共方法

隐藏继承的公共方法

显示继承的公共方法

	方法		由以下参数定义
		AutomationID() 构造函数。	AutomationID
		addFirst(p:AutomationIDPart):void 向 ID 的开头添加一个部分。	AutomationID
		addLast(p:AutomationIDPart):void 向 ID 的结尾添加一个部分。	AutomationID
		concat(other:AutomationID):AutomationID 将其它 ID 连接到此 ID。	AutomationID
		equals(other:AutomationID):Boolean 将此对象与给定的 AutomationID 相比较。	AutomationID
		hasOwnProperty(name:String):Boolean 表示对象是否已经定义了指定的属性。	Object
		isEmpty():Boolean 指示此 ID 是否包含更多部分。	AutomationID
		isPrototypeOf(theClass:Object):Boolean 表示 Object 类的实例是否在指定为参数的对象的原型链中。	Object
		parse(s:String):AutomationID [静态] 解析字符串并返回 ID。	AutomationID
		peekFirst():AutomationIDPart 返回 ID 中的第一个对象	AutomationID
		peekLast():AutomationIDPart 返回 ID 中的最后一个对象。	AutomationID
		propertyIsEnumerable(name:String):Boolean 表示指定的属性是否存在、是否可枚举。	Object
		removeFirst():AutomationIDPart 从此 ID 中删除第一个对象。	AutomationID
		removeLast():AutomationIDPart 从此 ID 中删除最后一个对象。	AutomationID
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 设置循环操作动态属性的可用性。	Object
		toLocaleString():String 返回此对象的字符串表示形式，其格式设置遵守区域设置特定的约定。	Object
		toString():String 将 ID 序列化为字符串。	AutomationID
		valueOf():Object 返回指定对象的原始值。	Object

属性详细信息

length

属性

length:int [只读]

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

此 ID 中的部分数。

实现
public function get length():int

构造函数详细信息

()

构造函数

public function AutomationID()

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

构造函数。

方法详细信息

addFirst

()

方法

public function addFirst(p:AutomationIDPart):void

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

向 ID 的开头添加一个部分。

参数

p:AutomationIDPart — 属性的映射。

addLast

()

方法

public function addLast(p:AutomationIDPart):void

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

向 ID 的结尾添加一个部分。

参数

p:AutomationIDPart — 属性的映射。

concat

()

方法

public function concat(other:AutomationID):AutomationID

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

将其它 ID 连接到此 ID。返回新的 ID，但不改变此实例。

参数

other:AutomationID — 要连接的 ID。

AutomationID — 此 ID 与另一个 ID 相连接。

equals

()

方法

public function equals(other:AutomationID):Boolean

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

将此对象与给定的 AutomationID 相比较。

参数

other:AutomationID — 需要进行比较的 AutomationID 对象。

Boolean — 如果相同，则返回 true，否则返回 false。

isEmpty

()

方法

public function isEmpty():Boolean

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

指示此 ID 是否包含更多部分。

Boolean — 如果此 ID 没有更多部分，则返回 true，否则返回 false。

parse

()

方法

public static function parse(s:String):AutomationID

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

解析字符串并返回 ID。

参数

s:String — 由 toString() 方法提供的 ID 的序列化格式。

AutomationID — 已解析的 ID。

peekFirst

()

方法

public function peekFirst():AutomationIDPart

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

返回 ID 中的第一个对象

AutomationIDPart — ID 中的第一个对象。

peekLast

()

方法

public function peekLast():AutomationIDPart

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

返回 ID 中的最后一个对象。

AutomationIDPart — ID 中的最后一个对象。

removeFirst

()

方法

public function removeFirst():AutomationIDPart

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

从此 ID 中删除第一个对象。

AutomationIDPart — 此 ID 中的第一个对象。

removeLast

()

方法

public function removeLast():AutomationIDPart

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

从此 ID 中删除最后一个对象。

AutomationIDPart — 此 ID 中的最后一个对象。

toString

()

方法

public function toString():String

语言版本:

ActionScript 3.0

产品版本:

Flex 3

运行时版本:

Flash Player 9, AIR 1.1

将 ID 序列化为字符串。

String — 序列化 ID。

法律声明 | 在线隐私策略

AutomationID - AS3 Flex

类 x

length

AutomationID

addFirst

addLast

concat

equals

isEmpty

parse

peekFirst

peekLast

removeFirst

removeLast

toString