(Disponível apenas no Flex 3 Pro)
Pacote mx.automation
Classe classe pública AutomationID
Herança AutomationID Inheritance Object

O framework do Flex automation usa a classe AutomationID para construir identificação de objeto que Agents podem usar. AutomationID consiste de várias AutomationIDParts, onde cada parte identifica um objeto na hierarquia. AutomationID define um formato de serialização para um Array de mapas. Você usa essa classe para representar uma hierarquia usando segmentos que descrevem propriedades de cada objeto dentro da hierarquia. O formato serializado do 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}

Considera o aplicativo Flex com a seguinte hierarquia: 

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

O AutomationID do button consistiria de quatro AutomationIDParts, uma para Application, uma para Accordion, uma para HBox, e uma para o Button. AutomationIDPart é um tabela de nomes de propriedades e seus valores. O par propriedade-valor são diferentes para diferentes tipos de objetos. Esses pares propriedade-valor poderão ser usados para identificar o objeto de forma exclusiva.

AutomationID é criado por walking a hierarquia parent do objeto leaf child e criando o AutomationIDPart para cada objeto encontrado. Parents que tem showInAutomationHierarchy colocados para false são pulados. Children de tal parents são coniderados os children do próximo parent mais alto, aonde o flag showInAuto é colocado como true. Durante gravação, esse AutomationID pode ser salvado pelo agent.

Durante playback quando Agent providencia AutomationID para encontrar um objeto, a hierarquia do objeto Display é encaminhado do objeto Application que está no topo para baixo. Em cada nível, o child que combina mais com o AutomationIDPart é apanhado da lista de todos os children. Se múltiplos children forem compatíveis com o padrão de comparação, um erro é lançado. Usuários são responsáveis por resolver tais conflitos providenciando um exclusivo automationName ou identificando novas propriedades em objetos que o tornam exclusivos.

Agents deveriam salvar a informação do objeto se eles desejam persistência. AutomationID providencia métodos toString() e parse() para converter o objeto em uma representação string e vice-versa.

Você pode usar os métodos IAutomationManager.createAutomationID() e IAutomationManager.resolveAutomationID() para criar e resolver objetos AutomationID, respectivamente.

Você pode usar os métodos IAutomationObjectHelper.helpCreateIDPart() e IAutomationObjectHelper.helpResolveIDPart() para identificar um child contido em um parent que combina com o AutomationIDPart.


Propriedades Públicas
  Propriedade Definido Por
 Inheritedconstructor : Object
Uma referência ao objeto da classe ou função construtora para uma instância determinada de um objeto.
Object
  length : int
[read-only] O número de parts nesse id.
AutomationID
 Inheritedprototype : Object
[static] Uma referência ao objeto protótipo de uma classe ou função de objeto.
Object
Métodos Públicos
  Método Definido Por
  
AutomationID()
Constructor.
AutomationID
  
addFirst(p:AutomationIDPart):void
Adiciona um parts para a frente do id.
AutomationID
  
addLast(p:AutomationIDPart):void
Adiciona um parts para o final do id.
AutomationID
  
concat(other:AutomationID):AutomationID
Concatena outro id para esse id.
AutomationID
  
equals(other:AutomationID):Boolean
Compara esse objeto com o dado AutomationID.
AutomationID
 Inherited
hasOwnProperty(name:String):Boolean
Indica se um objeto tem uma propriedade específica definida.
Object
  
isEmpty():Boolean
Indica se há mais parts do id.
AutomationID
 Inherited
isPrototypeOf(theClass:Object):Boolean
Indica se uma instância da classe Object está na corrente do protótipo do objeto determinado como parâmetro.
Object
  
parse(s:String):AutomationID
[static] Parses o string e retorna um id.
AutomationID
  
peekFirst():AutomationIDPart
Retorna o primeiro objeto no id.
AutomationID
  
peekLast():AutomationIDPart
Retorna o último objeto no id.
AutomationID
 Inherited
propertyIsEnumerable(name:String):Boolean
Indica se a propriedade especificada existe e se é enumerável.
Object
  
removeFirst():AutomationIDPart
Remove o primeiro objeto desse id.
AutomationID
  
removeLast():AutomationIDPart
Remove o último objeto desse id.
AutomationID
 Inherited
setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void
Determina a disponibilidade de uma propriedade dinâmica para operações em loop.
Object
  
toString():String
Serializa o id a um string.
AutomationID
 Inherited
valueOf():Object
Retorna o valor primitivo de um objeto específico.
Object
Detalhe da Propriedade
lengthproperty
length:int  [read-only]

O número de parts nesse id.


Implementação
    public function get length():int
Detalhe do Construtor
AutomationID()Constructor
public function AutomationID()

Constructor.

Detalhe do Método
addFirst()method
public function addFirst(p:AutomationIDPart):void

Adiciona um parts para a frente do id.

Parâmetros

p:AutomationIDPart — Mapa de propriedades.

addLast()method 
public function addLast(p:AutomationIDPart):void

Adiciona um parts para o final do id.

Parâmetros

p:AutomationIDPart — Mapa de propriedades.

concat()method 
public function concat(other:AutomationID):AutomationID

Concatena outro id para esse id. Retorna um novo id, e não modifica essa instância.

Parâmetros

other:AutomationID — id a ser concatenado.

Retorna
AutomationID — Esse id concatenado com o outro id.
equals()method 
public function equals(other:AutomationID):Boolean

Compara esse objeto com o dado AutomationID.

Parâmetros

other:AutomationID — Objeto AutomationID que precisa ser comparado.

Retorna
Boolean — true se são iguais, caso contrário false.
isEmpty()method 
public function isEmpty():Boolean

Indica se há mais parts do id.

Retorna
Boolean — true se não há mais parts do id, caso contrário false.
parse()method 
public static function parse(s:String):AutomationID

Parses o string e retorna um id.

Parâmetros

s:String — Forma serializada do id como providenciado pelo método toString().

Retorna
AutomationID — Parsed id.
peekFirst()method 
public function peekFirst():AutomationIDPart

Retorna o primeiro objeto no id.

Retorna
AutomationIDPart — Primeiro objeto no id.
peekLast()method 
public function peekLast():AutomationIDPart

Retorna o último objeto no id.

Retorna
AutomationIDPart — Último objeto no id.
removeFirst()method 
public function removeFirst():AutomationIDPart

Remove o primeiro objeto desse id.

Retorna
AutomationIDPart — Primeiro objeto nesse id.
removeLast()method 
public function removeLast():AutomationIDPart

Remove o último objeto desse id.

Retorna
AutomationIDPart — Último objeto nesse id.
toString()method 
public function toString():String

Serializa o id a um string.

Retorna
String — O id serializado.



© 2004-2007 Adobe Systems Incorporated. All rights reserved.
Sun Feb 17 2008, 2:46 AM GMT-08:00