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 |
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é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 | ||
Définit le gestionnaire d’automatisation sur le mode d’enregistrement. | IAutomationManager | ||
Renvoie pour l’objet donné un ID pouvant être utilisé avec la méthode resolveID(). | IAutomationManager | ||
Renvoie pour l’objet donné une partie d’ID pouvant être utilisée dans la méthode resolveIDPart(). | IAutomationManager | ||
Décrémente le compteur de cache. | IAutomationManager | ||
Distribue un événement dans le flux d’événements. | IEventDispatcher | ||
Extrait le gestionnaire d’automatisation hors du mode d’enregistrement. | IAutomationManager | ||
Renvoie le texte à afficher comme type de l’objet. | IAutomationManager | ||
Renvoie le texte à afficher comme description de l’objet. | IAutomationManager | ||
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 | ||
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 | ||
Rectangle d’affichage entourant l’objet DisplayObject. | IAutomationManager | ||
Renvoie l’objet implémentant l’interface IAutomationTabularData via laquelle les données tabulaires peuvent être obtenues. | IAutomationManager | ||
Vérifie si des écouteurs sont enregistrés auprès de l’objet EventDispatcher pour un type spécifique d’événement. | IEventDispatcher | ||
Incrémente le compteur de cache. | IAutomationManager | ||
Teste si la cible fournie doit attendre qu’une opération précédente se termine. | IAutomationManager | ||
Renvoie true si un objet et tous ses parents sont visibles. | IAutomationManager | ||
Enregistre l’événement. | IAutomationManager | ||
Enregistre l’événement personnalisé. | IAutomationManager | ||
Supprime un écouteur de l’objet EventDispatcher. | IEventDispatcher | ||
Réexécute l’événement spécifié. | IAutomationManager | ||
Résout un ID dans des objets d’automatisation. | IAutomationManager | ||
Résout une partie d’ID en un tableau d’objets d’automatisation. | IAutomationManager | ||
Résout une partie d’ID en un objet d’automatisation au sein du parent. | IAutomationManager | ||
Résout un ID en un objet d’automatisation. | IAutomationManager | ||
Indique si un objet d’automatisation doit être visible dans la hiérarchie. | IAutomationManager | ||
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 |
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
recording | propriété |
replaying | propriété |
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.
|
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.
|
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.
|
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.
|
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.
|
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 )
|
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 .
|
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.
|
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 .
|
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.
|
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.
|
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.
|
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.
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.
|
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.
|
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.
|
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.
|
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.
|
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.
|
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.
|
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.
|
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.
|
Boolean — true si l’objet doit être affiché dans la hiérarchie d’automatisation.
|
Tue Jun 12 2018, 09:30 AM Z