IAutomationManager - Guide de référence de l’API Adobe ActionScript® 3 (AS3 Flex)

Package	mx.automation
Interface	public interface IAutomationManager extends IEventDispatcher

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

L’interface IAutomationManager définit l’interface que le module d’automatisation attend de l’objet AutomationManager.

Propriétés publiques

	Propriété		Défini par
		automationEnvironment : Object Environnement d’automatisation de ce gestionnaire d’automatisation.	IAutomationManager
		recording : Boolean [lecture seule] Indique si l’enregistrement est en cours.	IAutomationManager
		replaying : Boolean [lecture seule] Indique si la réexécution est en cours.	IAutomationManager

Méthodes publiques

Masquer les méthodes publiques héritées

Afficher les méthodes publiques héritées

	Méthode		Défini par
		addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void Enregistre un objet écouteur d’événement auprès d’un objet EventDispatcher afin que l’écouteur soit averti d’un événement.	IEventDispatcher
		beginRecording():void Définit le gestionnaire d’automatisation sur le mode d’enregistrement.	IAutomationManager
		createID(obj:IAutomationObject, relativeToParent:IAutomationObject = null):AutomationID Renvoie pour l’objet donné un ID pouvant être utilisé avec la méthode resolveID().	IAutomationManager
		createIDPart(obj:IAutomationObject, parent:IAutomationObject = null):AutomationIDPart Renvoie pour l’objet donné une partie d’ID pouvant être utilisée dans la méthode resolveIDPart().	IAutomationManager
		decrementCacheCounter(clearNow:Boolean = false):int Décrémente le compteur de cache.	IAutomationManager
		dispatchEvent(event:Event):Boolean Distribue un événement dans le flux d’événements.	IEventDispatcher
		endRecording():void Extrait le gestionnaire d’automatisation hors du mode d’enregistrement.	IAutomationManager
		getAutomationClassName(obj:IAutomationObject):String Renvoie le texte à afficher comme type de l’objet.	IAutomationManager
		getAutomationName(obj:IAutomationObject):String Renvoie le texte à afficher comme description de l’objet.	IAutomationManager
		getChildren(obj:IAutomationObject, ignoreShowInHierarchy:Boolean = false):Array Renvoie tous les enfants de cet objet qui sont visibles dans la hiérarchie de test.	IAutomationManager
		getChildrenFromIDPart(obj:IAutomationObject, part:AutomationIDPart = null, ignoreShowInHierarchy:Boolean = false):Array Renvoie tous les enfants de cet objet qui sont visibles dans la hiérarchie de test et répondent au critère de la partie d’automatisation.	IAutomationManager
		getElementFromPoint(x:int, y:int):IAutomationObject Renvoie l’objet d’automatisation sous la coordonnée donnée.	IAutomationManager
		getParent(obj:IAutomationObject, parentToStopAt:IAutomationObject = null, ignoreShowInHierarchy:Boolean = false):IAutomationObject Renvoie le parent suivant qui est visible dans la hiérarchie d’automatisation.	IAutomationManager
		getProperties(obj:IAutomationObject, names:Array = null, forVerification:Boolean = true, forDescription:Boolean = true):Array Renvoie les valeurs d’un ensemble de propriétés.	IAutomationManager
		getRectangle(obj:DisplayObject):Array Rectangle d’affichage entourant l’objet DisplayObject.	IAutomationManager
		getTabularData(obj:IAutomationObject):mx.automation:IAutomationTabularData Renvoie l’objet implémentant l’interface IAutomationTabularData via laquelle les données tabulaires peuvent être obtenues.	IAutomationManager
		hasEventListener(type:String):Boolean Vérifie si des écouteurs sont enregistrés auprès de l’objet EventDispatcher pour un type spécifique d’événement.	IEventDispatcher
		incrementCacheCounter():int Incrémente le compteur de cache.	IAutomationManager
		isSynchronized(target:IAutomationObject):Boolean Teste si la cible fournie doit attendre qu’une opération précédente se termine.	IAutomationManager
		isVisible(obj:DisplayObject):Boolean Renvoie true si un objet et tous ses parents sont visibles.	IAutomationManager
		recordAutomatableEvent(recorder:IAutomationObject, event:Event, cacheable:Boolean = false):void Enregistre l’événement.	IAutomationManager
		recordCustomAutomationEvent(customEvent:AutomationRecordEvent):Boolean Enregistre l’événement personnalisé.	IAutomationManager
		removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void Supprime un écouteur de l’objet EventDispatcher.	IEventDispatcher
		replayAutomatableEvent(event:AutomationReplayEvent):Boolean Réexécute l’événement spécifié.	IAutomationManager
		resolveID(rid:AutomationID, currentParent:IAutomationObject = null):Array Résout un ID dans des objets d’automatisation.	IAutomationManager
		resolveIDPart(parent:IAutomationObject, part:AutomationIDPart):Array Résout une partie d’ID en un tableau d’objets d’automatisation.	IAutomationManager
		resolveIDPartToSingleObject(parent:IAutomationObject, part:AutomationIDPart):IAutomationObject Résout une partie d’ID en un objet d’automatisation au sein du parent.	IAutomationManager
		resolveIDToSingleObject(rid:AutomationID, currentParent:IAutomationObject = null):IAutomationObject Résout un ID en un objet d’automatisation.	IAutomationManager
		showInHierarchy(obj:IAutomationObject):Boolean Indique si un objet d’automatisation doit être visible dans la hiérarchie.	IAutomationManager
		willTrigger(type:String):Boolean Vérifie si un écouteur d’événement est enregistré auprès de cet objet EventDispatcher ou de ses ancêtres pour le type d’événement spécifié.	IEventDispatcher

Détails de la propriété

automationEnvironment

propriété

automationEnvironment:Object

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Environnement d’automatisation de ce gestionnaire d’automatisation. L’environnement d’automatisation fournit des informations sur les objets et propriétés des composants testables nécessaires pour communiquer avec les outils d’agents.

La valeur de cette propriété doit implémenter l’interface IAutomationEnvironment.

Implémentation
public function get automationEnvironment():Object
public function set automationEnvironment(value:Object):void

Eléments de l’API associés

mx.automation.IAutomationEnvironment

recording

propriété

recording:Boolean [lecture seule]

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Indique si l’enregistrement est en cours.

Implémentation
public function get recording():Boolean

replaying

propriété

replaying:Boolean [lecture seule]

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Indique si la réexécution est en cours.

Implémentation
public function get replaying():Boolean

Détails de la méthode

beginRecording

()

méthode

public function beginRecording():void

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Définit le gestionnaire d’automatisation sur le mode d’enregistrement.

createID

()

méthode

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

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Renvoie pour l’objet donné un ID pouvant être utilisé avec la méthode resolveID().

Paramètres

	`obj:IAutomationObject` — Objet d’automatisation.

	`relativeToParent:IAutomationObject` (default = `null`) — Parent de l’objet d’automatisation.

Valeur renvoyée

AutomationID — Objet AutomationID représentant l’objet d’automatisation.

createIDPart

()

méthode

public function createIDPart(obj:IAutomationObject, parent:IAutomationObject = null):AutomationIDPart

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Renvoie pour l’objet donné une partie d’ID pouvant être utilisée dans la méthode resolveIDPart().

Paramètres

	`obj:IAutomationObject` — Objet d’automatisation.

	`parent:IAutomationObject` (default = `null`) — Parent de l’objet d’automatisation.

Valeur renvoyée

AutomationIDPart — Objet AutomationIDPart représentant l’objet d’automatisation.

decrementCacheCounter

()

méthode

public function decrementCacheCounter(clearNow:Boolean = false):int

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Décrémente le compteur de cache. Le cache est effacé lorsque le décompte atteint zéro.

Paramètres

clearNow:Boolean (default = false) — Si true, efface le cache quel que soit le compteur de cache.

Valeur renvoyée

int — Compteur de cache actuel.

endRecording

()

méthode

public function endRecording():void

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Extrait le gestionnaire d’automatisation hors du mode d’enregistrement.

getAutomationClassName

()

méthode

public function getAutomationClassName(obj:IAutomationObject):String

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Renvoie le texte à afficher comme type de l’objet.

Paramètres

obj:IAutomationObject — Objet d’automatisation.

Valeur renvoyée

String — Type de l’objet.

getAutomationName

()

méthode

public function getAutomationName(obj:IAutomationObject):String

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Renvoie le texte à afficher comme description de l’objet.

Paramètres

obj:IAutomationObject — Objet d’automatisation.

Valeur renvoyée

String — Description textuelle de l’objet d’automatisation.

getChildren

()

méthode

public function getChildren(obj:IAutomationObject, ignoreShowInHierarchy:Boolean = false):Array

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Renvoie tous les enfants de cet objet visibles dans la hiérarchie de test. Si un enfant n’est pas visible dans la hiérarchie, renvoie les enfants de l’enfant invisible.

Paramètres

	`obj:IAutomationObject` — Objet pour lequel obtenir les enfants.

	`ignoreShowInHierarchy:Boolean` (default = `false`)

Valeur renvoyée

Array — Tableau d’enfants.

getChildrenFromIDPart

()

méthode

 public function getChildrenFromIDPart(obj:IAutomationObject, part:AutomationIDPart = null, ignoreShowInHierarchy:Boolean = false):Array

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Renvoie tous les enfants de cet objet qui sont visibles dans la hiérarchie de test et répondent au critère de la partie d’automatisation. Si un enfant n’est pas visible dans la hiérarchie, cette méthode renvoie les enfants de l’enfant invisible.

Paramètres

	`obj:IAutomationObject` — Objet pour lequel obtenir les enfants.

	`part:AutomationIDPart` (default = `null`) — Critère des enfants à renvoyer.

	`ignoreShowInHierarchy:Boolean` (default = `false`) — Valeur booléenne qui détermine si l’objet est ignoré dans la hiérarchie d’automatisation. La valeur par défaut est `false`.

Valeur renvoyée

Array — Tableau d’enfants qui répondent au critère.

getElementFromPoint

()

méthode

public function getElementFromPoint(x:int, y:int):IAutomationObject

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Renvoie l’objet d’automatisation sous la coordonnée donnée.

Paramètres

	`x:int` — Coordonnée x.

	`y:int` — Coordonnée y.

Valeur renvoyée

IAutomationObject — Objet d’automatisation à ce point.

getParent

()

méthode

 public function getParent(obj:IAutomationObject, parentToStopAt:IAutomationObject = null, ignoreShowInHierarchy:Boolean = false):IAutomationObject

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Renvoie le parent suivant qui est visible dans la hiérarchie d’automatisation.

Paramètres

	`obj:IAutomationObject` — Objet d’automatisation.

	`parentToStopAt:IAutomationObject` (default = `null`) — Parent de l’objet d’automatisation donné.

	`ignoreShowInHierarchy:Boolean` (default = `false`) — Valeur booléenne qui détermine si l’objet est ignoré dans la hiérarchie d’automatisation. La valeur par défaut est `false`.

Valeur renvoyée

IAutomationObject — Parent le plus proche de l’objet visible dans la hiérarchie d’automatisation.

getProperties

()

méthode

 public function getProperties(obj:IAutomationObject, names:Array = null, forVerification:Boolean = true, forDescription:Boolean = true):Array

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Renvoie les valeurs d’un ensemble de propriétés.

Paramètres

	`obj:IAutomationObject` — Objet pour lequel obtenir les propriétés.

	`names:Array` (default = `null`) — Noms des propriétés à évaluer sur l’objet.

	`forVerification:Boolean` (default = `true`) — Si `true`, n’inclut que les propriétés de vérification.

	`forDescription:Boolean` (default = `true`) — Si `true`, n’inclut que les propriétés de description.

Valeur renvoyée

Array — Tableau d’objets qui contiennent chaque valeur et descripteur de propriété.

getRectangle

()

méthode

public function getRectangle(obj:DisplayObject):Array

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Rectangle d’affichage entourant l’objet DisplayObject.

Paramètres

obj:DisplayObject — Objet DisplayObject dont le rectangle est voulu.

Valeur renvoyée

Array — Tableau de quatre entiers : haut, gauche, largeur et hauteur.

getTabularData

()

méthode

public function getTabularData(obj:IAutomationObject):mx.automation:IAutomationTabularData

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Renvoie l’objet implémentant l’interface IAutomationTabularData via laquelle les données tabulaires peuvent être obtenues.

Paramètres

obj:IAutomationObject — Objet IAutomationObject.

Valeur renvoyée

mx.automation:IAutomationTabularData — Objet implémentant l’interface IAutomationTabularData.

incrementCacheCounter

()

méthode

public function incrementCacheCounter():int

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Incrémente le compteur de cache. Le mécanisme d’automatisation met en cache les propriétés d’un objet et ses enfants. Le cache existe pour les deux raisons liées aux performances et pour qu’un état d’objet antérieur à un enregistrement puisse être capturé. Chaque appel à la méthode incrementCacheCounter() incrémente un compteur et chaque appel à la méthode decrementCacheCounter() décrémente le compteur de cache. Lorsque le compteur atteint zéro, le cache est effacé.

Il est important que les outils de test n’utilisent le cache que s’il est certain que l’application Flex est à l’état figé et que l’utilisateur ne peut pas interagir avec elle. Par exemple, lorsqu’un événement d’automatisation est enregistré, il se peut qu’un outil de test doive effectuer plusieurs appels à la méthode getChildren() ou getProperties() pour créer une ligne de script de test. Pour ce faire, il enveloppe tous les appels dans des appels de cache de démarrage/d’arrêt.

Le gestionnaire d’automatisation force en interne l’effacement du cache avant une interaction avec l’utilisateur final susceptible de déclencher un événement d’automatisation. Il incrémente alors le compteur de cache et décrémente le compteur après distribution de l’événement d’automatisation. Les outils de test peuvent empêcher le décompte d’atteindre zéro en appelant la méthode incrementCacheCounter() dans leur gestionnaire d’enregistrement.

Valeur renvoyée

int — Compteur de cache actuel.

isSynchronized

()

méthode

public function isSynchronized(target:IAutomationObject):Boolean

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Teste si la cible fournie doit attendre qu’une opération précédente se termine.

Paramètres

target:IAutomationObject — Cible à vérifier pour savoir si une synchronisation a eu lieu ou null pour effectuer une synchronisation sur des opérations en cours d’exécution.

Valeur renvoyée

Boolean — true si la synchronisation est terminée, false dans le cas contraire.

isVisible

()

méthode

public function isVisible(obj:DisplayObject):Boolean

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Renvoie true si un objet et tous ses parents sont visibles.

Paramètres

obj:DisplayObject — Classe DisplayObject.

Valeur renvoyée

Boolean — true si un objet et tous ses parents sont visibles.

recordAutomatableEvent

()

méthode

public function recordAutomatableEvent(recorder:IAutomationObject, event:Event, cacheable:Boolean = false):void

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Enregistre l’événement.

Paramètres

	`recorder:IAutomationObject` — Objet d’automatisation sur lequel l’événement doit être enregistré.

	`event:Event` — Evénement réel devant être enregistré.

	`cacheable:Boolean` (default = `false`) — Contrôle la mise en cache de l’événement enregistré. Pendant une séquence de déplacement de la souris vers le bas et vers le haut, le mécanisme d’automatisation tente d’enregistrer l’événement le plus important ou le plus adapté plutôt que tous les événements. Par exemple, si le rendu d’élément d’un contrôle List comporte un bouton. Lorsque l’utilisateur clique sur le bouton, le mécanisme d’automatisation n’enregistre que l’événement `click` du bouton et ignore l’événement `select` généré via le contrôle List.

recordCustomAutomationEvent

()

méthode

public function recordCustomAutomationEvent(customEvent:AutomationRecordEvent):Boolean

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Enregistre l’événement personnalisé.

Paramètres

customEvent:AutomationRecordEvent — Evénement AutomationRecordEvent qui indique qu’il s’agit d’un événement personnalisé ; le type est customRecord. Par exemple, si vous voulez enregistrer un événement personnalisé sans avoir à écrire un délégué et à fournir les détails dans un fichier d’environnement, vous pouvez utiliser cette interface. Vous devez écouter l’événement AutomationPlaybackEvent, gérer la réexécution et empêcher l’exécution par défaut sur l’événement AutomationPlaybackEvent.

Valeur renvoyée

Boolean

replayAutomatableEvent

()

méthode

public function replayAutomatableEvent(event:AutomationReplayEvent):Boolean

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Réexécute l’événement spécifié. Un auteur de composant doit probablement appeler l’événement super.replayAutomatableEvent() si le comportement de réexécution par défaut a été défini dans une super-classe.

Paramètres

event:AutomationReplayEvent — Evénement à réexécuter.

Valeur renvoyée

Boolean — true si la réexécution a réussi.

resolveID

()

méthode

public function resolveID(rid:AutomationID, currentParent:IAutomationObject = null):Array

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Résout un ID dans des objets d’automatisation.

Paramètres

	`rid:AutomationID` — ID d’automatisation de l’objet d’automatisation.

	`currentParent:IAutomationObject` (default = `null`) — Parent actuel de l’objet d’automatisation.

Valeur renvoyée

Array — Tableau contenant tous les objets qui correspondent au rid.

resolveIDPart

()

méthode

public function resolveIDPart(parent:IAutomationObject, part:AutomationIDPart):Array

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Résout une partie d’ID en un tableau d’objets d’automatisation.

Paramètres

	`parent:IAutomationObject` — Parent de l’objet d’automatisation.

	`part:AutomationIDPart` — Partie d’ID de l’objet d’automatisation.

Valeur renvoyée

Array — Tableau d’objets d’automatisation qui correspondent à part.

resolveIDPartToSingleObject

()

méthode

public function resolveIDPartToSingleObject(parent:IAutomationObject, part:AutomationIDPart):IAutomationObject

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Résout une partie d’ID en un objet d’automatisation au sein du parent.

Paramètres

	`parent:IAutomationObject` — Parent de l’objet d’automatisation.

	`part:AutomationIDPart` — Partie d’ID de l’objet d’automatisation.

Valeur renvoyée

IAutomationObject — Classe IAutomationObject qui correspond à part. Si aucun objet n’est trouvé ou que plusieurs objets sont trouvés, renvoie une exception.

resolveIDToSingleObject

()

méthode

public function resolveIDToSingleObject(rid:AutomationID, currentParent:IAutomationObject = null):IAutomationObject

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Résout un ID en un objet d’automatisation.

Paramètres

	`rid:AutomationID` — ID d’automatisation de l’objet d’automatisation.

	`currentParent:IAutomationObject` (default = `null`) — Parent actuel de l’objet d’automatisation.

Valeur renvoyée

IAutomationObject — Classe IAutomationObject qui correspond au rid. Si aucun objet n’est trouvé ou que plusieurs objets sont trouvés, cette méthode renvoie une exception.

showInHierarchy

()

méthode

public function showInHierarchy(obj:IAutomationObject):Boolean

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

Indique si un objet d’automatisation doit être visible dans la hiérarchie.

Paramètres

obj:IAutomationObject — Objet d’automatisation.

Valeur renvoyée

Boolean — true si l’objet doit être affiché dans la hiérarchie d’automatisation.

Informations juridiques | Politique de confidentialité en ligne

IAutomationManager - AS3 Flex

Packagesx

Eléments du langage

Annexes

Package mx.automation

automationEnvironment

recording

replaying

beginRecording

createID

createIDPart

decrementCacheCounter

endRecording

getAutomationClassName

getAutomationName

getChildren

getChildrenFromIDPart

getElementFromPoint

getParent

getProperties

getRectangle

getTabularData

incrementCacheCounter

isSynchronized

isVisible

recordAutomatableEvent

recordCustomAutomationEvent

replayAutomatableEvent

resolveID

resolveIDPart

resolveIDPartToSingleObject

resolveIDToSingleObject

showInHierarchy