AutomationID  - AS3 Flex

Package	mx.automation
Classe	public class AutomationID
Héritage	AutomationID Object

Version du langage:

ActionScript 3.0

Version du produit:

Flex 3

Versions du moteur d’exécution:

Flash Player 9, AIR 1.1

La structure d’automatisation Flex utilise la classe AutomationID pour construire l’identification d’objet que les agents peuvent utiliser. La classe AutomationID consiste en de nombreuses parties AutomationIDPart, chaque partie identifiant un objet dans la hiérarchie. La classe AutomationID définit un format de sérialisation pour un tableau de cartes. Vous utilisez cette classe pour représenter une hiérarchie avec des segments qui décrivent les propriétés de chaque objet dans la hiérarchie. Le format de sérialisation de l’ID est :

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}

Considérez une application Flex comportant la hiérarchie suivante :

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

La classe AutomationID du bouton consisterait en quatre parties AutomationIDPart : une pour la classe Application, une pour la classe Accordion, une pour la classe HBox et une pour la classe Button. La classe AutomationIDPart est un tableau de noms de propriétés et de leur valeurs. Les paires propriété-valeur diffèrent selon différents types d’objets. Ces paires propriété-valeur doivent pouvoir permettre d’identifier l’objet de manière unique.

La classe AutomationID est créée en parcourant la hiérarchie parent de l’objet enfant feuille et en créant la classe AutomationIDPart pour chaque objet rencontré. Les parents dont l’indicateur showInAutomationHierarchy est défini sur false sont ignorés. Les enfants de ces parents sont considérés comme les enfants du parent plus élevé suivant dont l’indicateur showInAuto est défini sur true. Pendant l’enregistrement, cette classe AutomationID peut être enregistrée par l’agent.

Pendant la lecture, lorsque l’agent fournit la classe AutomationID pour rechercher un objet, la hiérarchie de l’objet Display est parcourue de l’objet Application supérieur vers le bas. A chaque niveau, un enfant qui correspond le plus étroitement à la classe AutomationIDPart est extrait de la liste de tous les enfants. Si plusieurs enfants répondent au critère, une erreur est renvoyée. Les utilisateurs doivent résoudre de tels conflits en fournissant un nom automationName unique ou en identifiant sur les objets de nouvelles propriétés faisant d’eux des objets uniques.

Les agents doivent enregistrer les informations d’objets s’ils désirent les conserver. La classe AutomationID fournit les méthodes toString() et parse() pour convertir l’objet en une représentation de chaîne et vice versa.

Vous pouvez utiliser les méthodes IAutomationManager.createAutomationID() et IAutomationManager.resolveAutomationID() pour créer et résoudre des objets AutomationID, respectivement.

Vous pouvez utiliser les méthodes IAutomationObjectHelper.helpCreateIDPart() et IAutomationObjectHelper.helpResolveIDPart() pour identifier un enfant avec un parent correspondant à la classe AutomationIDPart.

---