(Disponível apenas no Flex 3 Pro)
Pacote mx.automation
Interface interface pública IAutomationManager extends IEventDispatcher

A interface IAutomationManager define a interface esperada de um objeto AutomationManager pelo módulo de automatização.


Propriedades Públicas
  Propriedade Definido Por
  automationEnvironment : Object
O ambiente de automatização para esse gerente de automatização.
IAutomationManager
  recording : Boolean
[read-only] Indica se está ocorrendo gravação, true, se não, false.
IAutomationManager
  replaying : Boolean
[read-only] Indica se está ocorrendo replay, true, se não, false.
IAutomationManager
Métodos Públicos
  Método Definido Por
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Registra um objeto event listener com um objeto do EventDispatcher para que o listener receba notificação de um evento.
IEventDispatcher
  
beginRecording():void
Coloca o automation manager para o modo record.
IAutomationManager
  
createID(obj:IAutomationObject, relativeToParent:IAutomationObject = null):AutomationID
Retorna um id para o dado objeto que pode ser usado com o método resolveID().
IAutomationManager
  
createIDPart(obj:IAutomationObject, parent:IAutomationObject = null):AutomationIDPart
Retorna um id part para o dado objeto que pode ser usado em resolveIDPart.
IAutomationManager
  
decrementCacheCounter(clearNow:Boolean = false):int
Decrementa o contador do cache.
IAutomationManager
 Inherited
dispatchEvent(event:Event):Boolean
Despacha um evento no fluxo de eventos.
IEventDispatcher
  
endRecording():void
Tira o automation manager do modo record.
IAutomationManager
  
getAutomationClassName(obj:IAutomationObject):String
Retorna o texto para display como o type do objeto.
IAutomationManager
  
getAutomationName(obj:IAutomationObject):String
Retorna o texto para display como a descrição para o objeto.
IAutomationManager
  
getChildren(obj:IAutomationObject, ignoreShowInHierarchy:Boolean = false):Array
Retorna todos os children desse objeto que estão visíveis dentro da hierarquia testing.
IAutomationManager
  
getChildrenFromIDPart(obj:IAutomationObject, part:AutomationIDPart = null, ignoreShowInHierarchy:Boolean = false):Array
Retorna todos os children desse objeto que estão visíveis dentro da hierarquia testing e que estão de acordo com os critérios no automation part.
IAutomationManager
  
getElementFromPoint(x:int, y:int):IAutomationObject
Retorna o objeto de automatização sob a dada coordenada.
IAutomationManager
  
getParent(obj:IAutomationObject, parentToStopAt:IAutomationObject = null, ignoreShowInHierarchy:Boolean = false):IAutomationObject
Retorna o próximo parent que está visível dentro da hierarquia automation.
IAutomationManager
  
getProperties(obj:IAutomationObject, names:Array = null, forVerification:Boolean = true, forDescription:Boolean = true):Array
Retorna os valors para um conjunto de propriedades.
IAutomationManager
  
getRectangle(obj:DisplayObject):Array
O retângulo display confinando o DisplayObject.
IAutomationManager
  
getTabularData(obj:IAutomationObject):IAutomationTabularData
Retorna o objeto implementando a interface IAutomationTabularData pelo qual os dados da tabela podem ser adquiridos.
IAutomationManager
 Inherited
hasEventListener(type:String):Boolean
Verifica se o objeto do EventDispatcher tem listeners registrados para um tipo determinado de evento.
IEventDispatcher
  
incrementCacheCounter():int
Incrementa no contador do cache.
IAutomationManager
  
isSynchronized(target:IAutomationObject):Boolean
Testa para ver se o target fornecido precisa esperar até que uma operação prévia se complete.
IAutomationManager
  
isVisible(obj:DisplayObject):Boolean
Retorna true se um objeto e todos seus parents estão visíveis.
IAutomationManager
  
recordAutomatableEvent(recorder:IAutomationObject, event:Event, cacheable:Boolean = false):void
Registra o evento.
IAutomationManager
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
Remove um listener do objeto do EventDispatcher.
IEventDispatcher
  
replayAutomatableEvent(event:AutomationReplayEvent):Boolean
Faz o replay do evento específico.
IAutomationManager
  
resolveID(rid:AutomationID, currentParent:IAutomationObject = null):Array
Determina um id para objetos de automatização.
IAutomationManager
  
resolveIDPart(parent:IAutomationObject, part:AutomationIDPart):Array
Determina um id part para um Array de objetos automation.
IAutomationManager
  
resolveIDPartToSingleObject(parent:IAutomationObject, part:AutomationIDPart):IAutomationObject
Determina um id part para um objeto de automation dentro do parent.
IAutomationManager
  
resolveIDToSingleObject(rid:AutomationID, currentParent:IAutomationObject = null):IAutomationObject
Determina um id a um objeto de automation.
IAutomationManager
  
showInHierarchy(obj:IAutomationObject):Boolean
Indica se um objeto de automation deveria ser visível dentro da hierarquia.
IAutomationManager
 Inherited
willTrigger(type:String):Boolean
Verifica se um event listener está registrado com esse objeto do EventDispatcher ou qualquer um de seus parents para o determinado tipo de evento.
IEventDispatcher
Detalhe da Propriedade
automationEnvironmentproperty
automationEnvironment:Object  [read-write]

O ambiente de automatização para esse gerente de automatização. O ambiente do automation providencia informação sobre os objetos e propriedades componentes testáveis necessárias para comunicar com ferramentas do agent. O valor dessa propriedade deve implementar a interface IAutomationEnvironment.


Implementação
    public function get automationEnvironment():Object
    public function set automationEnvironment(value:Object):void

Ver também

mx.automation.IAutomationEnvironment
recordingproperty 
recording:Boolean  [read-only]

Indica se está ocorrendo gravação, true, se não, false.


Implementação
    public function get recording():Boolean
replayingproperty 
replaying:Boolean  [read-only]

Indica se está ocorrendo replay, true, se não, false.


Implementação
    public function get replaying():Boolean
Detalhe do Método
beginRecording()method
public function beginRecording():void

Coloca o automation manager para o modo record.

createID()method 
public function createID(obj:IAutomationObject, relativeToParent:IAutomationObject = null):AutomationID

Retorna um id para o dado objeto que pode ser usado com o método resolveID().

Parâmetros

obj:IAutomationObject — Objeto Automation.
 
relativeToParent:IAutomationObject (default = null) — Parent do objeto de automatização.

Retorna
AutomationID — Objeto AutomationID que representa o objeto Automation.
createIDPart()method 
public function createIDPart(obj:IAutomationObject, parent:IAutomationObject = null):AutomationIDPart

Retorna um id part para o dado objeto que pode ser usado em resolveIDPart.

Parâmetros

obj:IAutomationObject — O objeto de automatização.
 
parent:IAutomationObject (default = null) — Parent do objeto de automatização.

Retorna
AutomationIDPart — Objeto AutomationIDPart que representa o objeto Automation.
decrementCacheCounter()method 
public function decrementCacheCounter(clearNow:Boolean = false):int

Decrementa o contador do cache. O cache é limpado quando o contador chega ao zero.

Parâmetros

clearNow:Boolean (default = false) — Se true, limpa o cache independente do cache counter.

Retorna
int — Atual cache counter.
endRecording()method 
public function endRecording():void

Tira o automation manager do modo record.

getAutomationClassName()method 
public function getAutomationClassName(obj:IAutomationObject):String

Retorna o texto para display como o type do objeto.

Parâmetros

obj:IAutomationObject — Objeto Automation.

Retorna
String — Type do objeto.
getAutomationName()method 
public function getAutomationName(obj:IAutomationObject):String

Retorna o texto para display como a descrição para o objeto.

Parâmetros

obj:IAutomationObject — Objeto Automation.

Retorna
String — Descrição de texto do objeto Automation.
getChildren()method 
public function getChildren(obj:IAutomationObject, ignoreShowInHierarchy:Boolean = false):Array

Retorna todos os children desse objeto que estão visíveis dentro da hierarquia testing. Se um child não está visível dentro da hierarquia, retorna os children do child invisível.

Parâmetros

obj:IAutomationObject — Objeto com qual pegar os children.
 
ignoreShowInHierarchy:Boolean (default = false)

Retorna
Array — Array de children.
getChildrenFromIDPart()method 
public function getChildrenFromIDPart(obj:IAutomationObject, part:AutomationIDPart = null, ignoreShowInHierarchy:Boolean = false):Array

Retorna todos os children desse objeto que estão visíveis dentro da hierarquia testing e que estão de acordo com os critérios no automation part. Se um child não estiver visível dentro da hierarquia, esse método retorna os childrend do child invisível.

Parâmetros

obj:IAutomationObject — Objeto com qual pegar os children.
 
part:AutomationIDPart (default = null) —Critério para qual os children retornar.
 
ignoreShowInHierarchy:Boolean (default = false) — Boolean que determina se o objeto é ignorado dentro da hierarquia do automation. O valor padrão é false.

Retorna
Array — Array de children compatível com os critérios.
getElementFromPoint()method 
public function getElementFromPoint(x:int, y:int):IAutomationObject

Retorna o objeto de automatização sob a dada coordenada.

Parâmetros

x:int — A coordenada x.
 
y:int — A coordenada y..

Retorna
IAutomationObject — Objeto automation naquele ponto.
getParent()method 
public function getParent(obj:IAutomationObject, parentToStopAt:IAutomationObject = null, ignoreShowInHierarchy:Boolean = false):IAutomationObject

Retorna o próximo parent que está visível dentro da hierarquia automation.

Parâmetros

obj:IAutomationObject — Objeto Automation.
 
parentToStopAt:IAutomationObject (default = null) — Parent do dado objeto de automatização.
 
ignoreShowInHierarchy:Boolean (default = false) — Boolean que determina se o objeto é ignorado dentro da hierarquia do automation. O valor padrão é false.

Retorna
IAutomationObject — Parente mais próximo do objeto visível dentro da hierarquia do automation.
getProperties()method 
public function getProperties(obj:IAutomationObject, names:Array = null, forVerification:Boolean = true, forDescription:Boolean = true):Array

Retorna os valors para um conjunto de propriedades.

Parâmetros

obj:IAutomationObject — Objeto para o qual pegar as propriedades.
 
names:Array (default = null) — Nomes das propriedade para evaluation no objeto.
 
forVerification:Boolean (default = true) — Se true, só incluir propriedades de verificação.
 
forDescription:Boolean (default = true) — Se true, incluir apenas propriedades de descrição.

Retorna
Array — Array de objetos que contém cada valor de propriedade e descriptor.
getRectangle()method 
public function getRectangle(obj:DisplayObject):Array

O retângulo display confinando o DisplayObject.

Parâmetros

obj:DisplayObject — DisplayObject cujo retângulo é desejado.

Retorna
Array — Um array de quatro números inteiros: top, left, width e height.
getTabularData()method 
public function getTabularData(obj:IAutomationObject):IAutomationTabularData

Retorna o objeto implementando a interface IAutomationTabularData pelo qual os dados da tabela podem ser adquiridos.

Parâmetros

obj:IAutomationObject — Um IAutomationObject.

Retorna
IAutomationTabularData — Um object implementando a interface IAutomationTabularData.
incrementCacheCounter()method 
public function incrementCacheCounter():int

Incrementa no contador do cache. O cache do mecanismo de automation é a propriedade do objeto e seu children. O cache existe para ambas razões de performance, e para que o estado de um objeto previamente a ser registrado possa ser capturado. Cada chamada para o método incrementCacheCounter() incrementa um counter e cada chamada para o método decrementCacheCounter() decrementa um cache counter. Quando o counter atinge zero o cache is limpado.

É important que as ferramentas usadas para testar utilizam o cache apenas quando estão certos que o estado do aplicativo do Flex está congelado e o usuário não pode interagir com ele. Por exemplo, quando um evento de automatização é registrado, uma ferramenta para testar pode ser necessária para fazer várias chamadas para o método getChildren() ou o método getProperties() para criar uma linha de testes do script. Para fazer isso, encerraria todas as chamadas em chamadas do cache start/stop.

O AutomationManager internamente e forçadamente limpa o cache antes que uma interação end-user que pode disparar um evento do automation. Depois incrementa o contador do cache e decrementa o contador depois que o evento do automation é despachado. Ferramentas de testagem podem prevenir a contagem de atingir zero chamando increment em seu record handler.

Retorna
int — o atual cache counter.
isSynchronized()method 
public function isSynchronized(target:IAutomationObject):Boolean

Testa para ver se o target fornecido precisa esperar até que uma operação prévia se complete.

Parâmetros

target:IAutomationObject — Target para verificar sincorinização ou null para sincronizar em qualquer operação em execução.

Retorna
Boolean — true se sincronização estiver completa, caso contrário false.
isVisible()method 
public function isVisible(obj:DisplayObject):Boolean

Retorna true se um objeto e todos seus parents estão visíveis.

Parâmetros

obj:DisplayObject — DisplayObject.

Retorna
Boolean — true se um objeto e todos os seus parents estão visíveis.
recordAutomatableEvent()method 
public function recordAutomatableEvent(recorder:IAutomationObject, event:Event, cacheable:Boolean = false):void

Registra o evento.

Parâmetros

recorder:IAutomationObject — O objeto de automation no qual o evento será gravado.
 
evento:Event — O atual evento que precisa ser registrado.
 
cacheable:Boolean (default = false) — Usado para controlar o caching do evento que deveria ser registrado. Durante uma sequencia mouse-down, mouse-up, o mecanismo de automation tenta registrar o evento mais importante ou adequado ao inves de todos os eventos. Por exemplo, suponha que você tem um controle List que tem um button em seu item renderer. Quando o usuário clica no button, o mecanismo do automation só registra o evento click para o button, mas ignora o evento select gerado do controle List.

replayAutomatableEvent()method 
public function replayAutomatableEvent(event:AutomationReplayEvent):Boolean

Faz o replay do evento específico. Um component author deve chamar o método super.replayAutomatableEvent() no caso do comportamento replay padrão foi definido em um superclass.

Parâmetros

evento:AutomationReplayEvent — Evento para ser feito o replay.

Retorna
Boolean — true se o replay foi bem sucedido.
resolveID()method 
public function resolveID(rid:AutomationID, currentParent:IAutomationObject = null):Array

Determina um id para objetos de automatização.

Parâmetros

rid:AutomationID — id do Automation do objeto de automatização.
 
currentParent:IAutomationObject (default = null) — Presente parent do objeto de automatização.

Retorna
Array — Um Array contendo todos os objetos combinando com o rid.
resolveIDPart()method 
public function resolveIDPart(parent:IAutomationObject, part:AutomationIDPart):Array

Determina um id part para um Array de objetos automation.

Parâmetros

parent:IAutomationObject — Parent do objeto de automatização.
 
part:AutomationIDPart — id part do objeto de automatização.

Retorna
Array — Array de objetos automation com match part.
resolveIDPartToSingleObject()method 
public function resolveIDPartToSingleObject(parent:IAutomationObject, part:AutomationIDPart):IAutomationObject

Determina um id part para um objeto de automation dentro do parent.

Parâmetros

parent:IAutomationObject — Parent do objeto de automatização.
 
part:AutomationIDPart — id part do objeto de automatização.

Retorna
IAutomationObject — IAutomationObject que combina com o part. Se nenhum objeto é encontrado ou se múltiplos objetos são encotrados, coloque uma excessão.
resolveIDToSingleObject()method 
public function resolveIDToSingleObject(rid:AutomationID, currentParent:IAutomationObject = null):IAutomationObject

Determina um id a um objeto de automation.

Parâmetros

rid:AutomationID — id do Automation do objeto de automatização.
 
currentParent:IAutomationObject (default = null) — Presente parent do objeto de automatização.

Retorna
IAutomationObject — IAutomationObject que com o rid. Se nenhum objeto é encontrado ou múltiplos objetos são encontrados, coloque uma excessão.
showInHierarchy()method 
public function showInHierarchy(obj:IAutomationObject):Boolean

Indica se um objeto de automation deveria ser visível dentro da hierarquia.

Parâmetros

obj:IAutomationObject — O objeto de automatização.

Retorna
Boolean — true se o objeto deve ser mostrado dentro da hierarquia automation.



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