AutomationID  - AS3 Flex

Пакет	mx.automation
Класс	public class AutomationID
Наследование	AutomationID Object

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

В инфраструктуре автоматизации Flex класс AutomationID используется для создания идентификаторов объектов, используемых агентами. AutomationID состоит из нескольких AutomationIDParts, где каждая часть идентифицирует объект в иерархии. AutomationID определяет формат сериализации для массива карт. Этот класс используется для представления иерархии с помощью сегментов, которые описывают свойства каждого объекта в иерархии. Формат сериализации для идентификатора:

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}

Предположим, что приложение Flex имеет следующую иерархию:

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

Тогда AutomationID кнопки состоит из четырех частей AutomationIDParts, одна для Application, одна для Accordion, одна для HBox и одна для Button. AutomationIDPart – это таблица имен свойств и их значений. Пары «значение – свойство» различаются для разных типов объектов. Эти пары «значение – свойство» должны быть удобными для однозначной идентификации объекта.

AutomationID создается путем просмотра вышестоящей иерархии листового нижестоящего объекта и создания AutomationIDPart для каждого найденного объекта. Вышестоящие элементы, для которых значение showInAutomationHierarchy установлено равным false, пропускаются. Нижестоящие элементы этих вышестоящих элементов считаются нижестоящими для следующего вышестоящего элемента, значение флага showInAuto которого установлено равным true. Во время записи этот AutomationID может быть сохранен агентом.

Во время воспроизведения, когда Агент предоставляет AutomationID для поиска объекта, иерархия объекта Display просматривается сверху вниз, начиная с верхнего объекта Application. На каждом уровне из списка всех нижестоящих элементов выбирается нижестоящий элемент, наиболее соответствующий AutomationIDPart. Если критерию соответствуют несколько нижестоящих элементов, то будет выведено сообщение об ошибке. Пользователи несут ответственность за разрешение этих конфликтов путем предоставления уникального имени automationName или определения новых свойств объектов для придания им уникальности.

Для устойчивости агентам следует сохранить информацию объекта. Для преобразования объекта в строковое представление и обратно в AutomationID предусмотрены методы toString() и parse().

Для создания и определения объектов AutomationID можно использовать методы IAutomationManager.createAutomationID() и IAutomationManager.resolveAutomationID() соответственно.

Для идентификации нижестоящего элемента в рамках вышестоящего элемента, который соответствует AutomationIDPart, можно использовать методы IAutomationObjectHelper.helpCreateIDPart() и IAutomationObjectHelper.helpResolveIDPart().

---