（仅限 Flex 数据可视化）
包mx.automation
类public class AutomationID
继承AutomationID Inheritance Object

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 匹配的子项。


公共属性
 属性定义方
 Inheritedconstructor : Object
对类对象或给定对象实例的构造函数的引用。
Object
  length : int
[只读 (read-only)] 此 ID 中的部分数。
AutomationID
 Inheritedprototype : Object
[静态] 对类或函数对象的原型对象的引用。
Object
公共方法
 方法定义方
  
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
 Inherited
hasOwnProperty(name:String):Boolean
指示对象是否已经定义了指定的属性。
Object
  
isEmpty():Boolean
指示此 ID 是否包含更多部分。
AutomationID
 Inherited
isPrototypeOf(theClass:Object):Boolean
指示 Object 类的实例是否在指定为参数的对象的原型链中。
Object
  
parse(s:String):AutomationID
[静态] 解析字符串并返回 ID。
AutomationID
  
peekFirst():AutomationIDPart
返回 ID 中的第一个对象
AutomationID
  
peekLast():AutomationIDPart
返回 ID 中的最后一个对象。
AutomationID
 Inherited
propertyIsEnumerable(name:String):Boolean
指示指定的属性是否存在、是否可枚举。
Object
  
removeFirst():AutomationIDPart
从此 ID 中删除第一个对象。
AutomationID
  
removeLast():AutomationIDPart
从此 ID 中删除最后一个对象。
AutomationID
 Inherited
setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void
设置循环操作动态属性的可用性。
Object
  
toString():String
将 ID 序列化为字符串。
AutomationID
 Inherited
valueOf():Object
返回指定对象的原始值。
Object
属性详细信息
length属性
length:int  [只读 (read-only)]

此 ID 中的部分数。



实现
    public function get length():int
构造函数详细信息
AutomationID()构造函数
public function AutomationID()

构造函数。

方法详细信息
addFirst()方法
public function addFirst(p:AutomationIDPart):void

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

参数

p:AutomationIDPart — 属性的映射。

addLast()方法 
public function addLast(p:AutomationIDPart):void

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

参数

p:AutomationIDPart — 属性的映射。

concat()方法 
public function concat(other:AutomationID):AutomationID

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

参数

other:AutomationID — 要连接的 ID。

返回
AutomationID — 此 ID 与其它 ID 相连接。
equals()方法 
public function equals(other:AutomationID):Boolean

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

参数

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

返回
Boolean — 如果相同，则返回 true，否则返回 false。
isEmpty()方法 
public function isEmpty():Boolean

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

返回
Boolean — 如果此 ID 没有更多部分，则返回 true，否则返回 false。
parse()方法 
public static function parse(s:String):AutomationID

解析字符串并返回 ID。

参数

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

返回
AutomationID — 已解析的 ID。
peekFirst()方法 
public function peekFirst():AutomationIDPart

返回 ID 中的第一个对象

返回
AutomationIDPart — ID 中的第一个对象。
peekLast()方法 
public function peekLast():AutomationIDPart

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

返回
AutomationIDPart — ID 中的最后一个对象。
removeFirst()方法 
public function removeFirst():AutomationIDPart

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

返回
AutomationIDPart — 此 ID 中的第一个对象。
removeLast()方法 
public function removeLast():AutomationIDPart

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

返回
AutomationIDPart — 此 ID 中的最后一个对象。
toString()方法 
public function toString():String

将 ID 序列化为字符串。

返回
String — 序列化 ID。



© 2004-2008 Adobe Systems Incorporated. All rights reserved.
Sun Dec 14 2008, 10:39 PM -08:00