Пакет | mx.automation |
Интерфейс | public interface IAutomationManager extends IEventDispatcher |
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Свойство | Определено | ||
---|---|---|---|
automationEnvironment : Object
Среда автоматизации для этого диспетчера автоматизации. | IAutomationManager | ||
recording : Boolean [только для чтения]
Указывает, выполняется ли запись. | IAutomationManager | ||
replaying : Boolean [только для чтения]
Указывает, выполняется ли повтор. | IAutomationManager |
Метод | Определено | ||
---|---|---|---|
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Регистрирует объект прослушивателя события на объекте EventDispatcher для получения прослушивателем уведомления о событии. | IEventDispatcher | ||
Переводит диспетчер автоматизации в режим записи. | IAutomationManager | ||
Возвращает идентификатор этого объекта, который можно использовать с методом resolveID(). | IAutomationManager | ||
Возвращает идентификационную часть для этого объекта, которую можно использовать с методом resolveIDPart(). | IAutomationManager | ||
Уменьшает значение счетчика кэша на единицу. | IAutomationManager | ||
Посылает событие в поток событий. | IEventDispatcher | ||
Выводит диспетчер автоматизации из режима записи. | IAutomationManager | ||
Возвращает текст, отображаемый в качестве типа объекта. | IAutomationManager | ||
Возвращает текст, отображаемый в качестве описания объекта. | IAutomationManager | ||
Возвращает все нижестоящие элементы для этого объекта, видимые в иерархии тестирования. | IAutomationManager | ||
getChildrenFromIDPart(obj:IAutomationObject, part:AutomationIDPart = null, ignoreShowInHierarchy:Boolean = false):Array
Возвращает все нижестоящие элементы для этого объекта, которые видимы в иерархии тестирования и удовлетворяют критериям в части автоматизации. | IAutomationManager | ||
Возвращает объект автоматизации в данной координате. | IAutomationManager | ||
getParent(obj:IAutomationObject, parentToStopAt:IAutomationObject = null, ignoreShowInHierarchy:Boolean = false):IAutomationObject
Возвращает следующий вышестоящий элемент, видимый в иерархии автоматизации. | IAutomationManager | ||
getProperties(obj:IAutomationObject, names:Array = null, forVerification:Boolean = true, forDescription:Boolean = true):Array
Возвращает значения для набора свойств. | IAutomationManager | ||
Прямоугольная отображаемая область, включающая DisplayObject. | IAutomationManager | ||
Возвращает объект, реализующий интерфейс IAutomationTabularData, через который можно извлечь табличные данные. | IAutomationManager | ||
Проверяет, имеет ли объект EventDispatcher прослушиватели, зарегистрированные для определенного типа события. | IEventDispatcher | ||
Увеличивает значение счетчика кэша на единицу. | IAutomationManager | ||
Выполняет тестирование, если предоставленная цель находится в состоянии ожидания завершения предыдущей операции. | IAutomationManager | ||
Возвращает значение true, если объект и все вышестоящие элементы видимы. | IAutomationManager | ||
Записывает событие. | IAutomationManager | ||
Записывает пользовательское событие. | IAutomationManager | ||
Удаляет прослушиватель из объекта EventDispatcher. | IEventDispatcher | ||
Воспроизводит указанное событие. | IAutomationManager | ||
Связывает идентификатор с объектами автоматизации. | IAutomationManager | ||
Связывает идентификационную часть с массивом объектов автоматизации. | IAutomationManager | ||
Связывает идентификационную часть с объектом автоматизации в вышестоящем элементе. | IAutomationManager | ||
Связывает идентификатор с объектом автоматизации. | IAutomationManager | ||
Указывает, является ли объект автоматизации видимым в иерархии автоматизации. | IAutomationManager | ||
Проверяет, зарегистрирован ли прослушиватель события для указанного типа события с данным объектом EventDispatcher или любым его предшественником. | IEventDispatcher |
automationEnvironment | свойство |
automationEnvironment:Object
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Среда автоматизации для этого диспетчера автоматизации. Среда автоматизации предоставляет информацию об объектах и свойствах тестируемых компонентов, необходимых для взаимодействия с инструментальными средствами агента.
Значение этого свойства должно реализовать интерфейс IAutomationEnvironment.
Реализация
public function get automationEnvironment():Object
public function set automationEnvironment(value:Object):void
Связанные элементы API
recording | свойство |
replaying | свойство |
beginRecording | () | метод |
public function beginRecording():void
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Переводит диспетчер автоматизации в режим записи.
createID | () | метод |
public function createID(obj:IAutomationObject, relativeToParent:IAutomationObject = null):AutomationID
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Возвращает идентификатор этого объекта, который можно использовать с методом resolveID()
.
Параметры
obj:IAutomationObject — Объект автоматизации.
| |
relativeToParent:IAutomationObject (default = null ) — Вышестоящий элемент для объекта автоматизации.
|
AutomationID — Объект AutomationID, который представляет собой объект Automation.
|
createIDPart | () | метод |
public function createIDPart(obj:IAutomationObject, parent:IAutomationObject = null):AutomationIDPart
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Возвращает идентификационную часть для этого объекта, которую можно использовать с методом resolveIDPart()
.
Параметры
obj:IAutomationObject — Объект автоматизации.
| |
parent:IAutomationObject (default = null ) — Вышестоящий элемент для объекта автоматизации.
|
AutomationIDPart — Объект AutomationIDPart, который представляет собой объект Automation.
|
decrementCacheCounter | () | метод |
public function decrementCacheCounter(clearNow:Boolean = false):int
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Уменьшает значение счетчика кэша на единицу. Кэш очищен, когда счетчик имеет нулевое значение.
Параметры
clearNow:Boolean (default = false ) — При значении true , очистка кэша выполняется независимо от счетчика кэша.
|
int — Текущий счетчик кэша.
|
endRecording | () | метод |
public function endRecording():void
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Выводит диспетчер автоматизации из режима записи.
getAutomationClassName | () | метод |
public function getAutomationClassName(obj:IAutomationObject):String
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Возвращает текст, отображаемый в качестве типа объекта.
Параметры
obj:IAutomationObject — Объект автоматизации.
|
String — Тип объекта.
|
getAutomationName | () | метод |
public function getAutomationName(obj:IAutomationObject):String
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Возвращает текст, отображаемый в качестве описания объекта.
Параметры
obj:IAutomationObject — Объект автоматизации.
|
String — Текстовое описание объекта Automation.
|
getChildren | () | метод |
public function getChildren(obj:IAutomationObject, ignoreShowInHierarchy:Boolean = false):Array
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Возвращает все нижестоящие элементы для этого объекта, видимые в иерархии тестирования. Если нижестоящий элемент не видим в иерархии, то возвращает нижестоящие элементы невидимого нижестоящего элемента.
Параметры
obj:IAutomationObject — Объект, для которого извлекаются нижестоящие элементы.
| |
ignoreShowInHierarchy:Boolean (default = false )
|
Array — Массив нижестоящих элементов.
|
getChildrenFromIDPart | () | метод |
public function getChildrenFromIDPart(obj:IAutomationObject, part:AutomationIDPart = null, ignoreShowInHierarchy:Boolean = false):Array
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Возвращает все нижестоящие элементы для этого объекта, которые видимы в иерархии тестирования и удовлетворяют критериям в части автоматизации. Если нижестоящий элемент не видим в иерархии, то этот метод возвращает нижестоящие элементы невидимого нижестоящего элемента.
Параметры
obj:IAutomationObject — Объект, для которого извлекаются нижестоящие элементы.
| |
part:AutomationIDPart (default = null ) — Критерии, для которых следует вернуть нижестоящие элементы.
| |
ignoreShowInHierarchy:Boolean (default = false ) — Логическое значение, которое определяет, игнорируется ли объект в иерархии автоматизации. Значение по умолчанию false .
|
Array — Массив нижестоящих элементов, соответствующих критериям.
|
getElementFromPoint | () | метод |
public function getElementFromPoint(x:int, y:int):IAutomationObject
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Возвращает объект автоматизации в данной координате.
Параметры
x:int — Координата x.
| |
y:int — Координата y.
|
IAutomationObject — Объект автоматизации в этой точке.
|
getParent | () | метод |
public function getParent(obj:IAutomationObject, parentToStopAt:IAutomationObject = null, ignoreShowInHierarchy:Boolean = false):IAutomationObject
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Возвращает следующий вышестоящий элемент, видимый в иерархии автоматизации.
Параметры
obj:IAutomationObject — Объект автоматизации.
| |
parentToStopAt:IAutomationObject (default = null ) — Вышестоящий элемент для данного объекта автоматизации.
| |
ignoreShowInHierarchy:Boolean (default = false ) — Логическое значение, которое определяет, игнорируется ли объект в иерархии автоматизации. Значение по умолчанию false .
|
IAutomationObject — Ближайший вышестоящий элемент для объекта, видимый в иерархии автоматизации.
|
getProperties | () | метод |
public function getProperties(obj:IAutomationObject, names:Array = null, forVerification:Boolean = true, forDescription:Boolean = true):Array
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Возвращает значения для набора свойств.
Параметры
obj:IAutomationObject — Объект, для которого следует извлечь свойства.
| |
names:Array (default = null ) — Имена свойств для анализа объекта.
| |
forVerification:Boolean (default = true ) — При значении true включаются только свойства проверок.
| |
forDescription:Boolean (default = true ) — При значении true включаются только свойства описаний.
|
Array — Массив объектов, которые содержат и значение свойства, и дескриптор.
|
getRectangle | () | метод |
public function getRectangle(obj:DisplayObject):Array
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Прямоугольная отображаемая область, включающая DisplayObject.
Параметры
obj:DisplayObject — DisplayObject, прямоугольник которого необходим.
|
Array — Массив из четырех целых чисел: top, left, width и height.
|
getTabularData | () | метод |
public function getTabularData(obj:IAutomationObject):mx.automation:IAutomationTabularData
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Возвращает объект, реализующий интерфейс IAutomationTabularData, через который можно извлечь табличные данные.
Параметры
obj:IAutomationObject — IAutomationObject.
|
mx.automation:IAutomationTabularData — Объект, реализующий интерфейс IAutomationTabularData.
|
incrementCacheCounter | () | метод |
public function incrementCacheCounter():int
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Увеличивает значение счетчика кэша на единицу. Механизм автоматизации кэширует и свойства объекта, и его нижестоящие элементы. Кэш необходим как для производительности, так и для захвата состояния объекта перед записью. Каждый вызов метода incrementCacheCounter()
увеличивает значение счетчика на единицу, каждый вызов метода decrementCacheCounter()
уменьшает значение счетчика кэша на единицу. При достижении счетчиком нулевого значения кэш очищен.
Использование кэша инструментами тестирования важно допускать только при полной уверенности, что приложение Flex фиксировано и пользователь не может совершать в нем никаких действий. Например, при записи события автоматизации инструментом тестирования может быть выполнено несколько вызовов метода getChildren()
или метода getProperties()
для создания строки сценария тестирования. С этой целью все вызовы начала/останова кэша будут завершены.
AutomationManager принудительно очищает кэш на внутреннем уровне перед действием пользователя, которое может инициировать событие автоматизации. Затем увеличивает значение счетчика кэша на единицу и уменьшает значение счетчика после передачи события автоматизации. Инструменты тестирования могут помешать счетчику достигнуть нулевого значения путем вызова метода incrementCacheCounter()
в обработчике записей.
int — текущий счетчик кэша.
|
isSynchronized | () | метод |
public function isSynchronized(target:IAutomationObject):Boolean
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Выполняет тестирование, если предоставленная цель находится в состоянии ожидания завершения предыдущей операции.
Параметры
target:IAutomationObject — Цель, для которой проверяется синхронизация, или null для выполнения синхронизации с любой выполняющейся операцией.
|
Boolean — Значение true , если синхронизация завершена, в противном случае – false .
|
isVisible | () | метод |
public function isVisible(obj:DisplayObject):Boolean
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Возвращает значение true
, если объект и все вышестоящие элементы видимы.
Параметры
obj:DisplayObject — DisplayObject.
|
Boolean — Значение true , если объект и все вышестоящие элементы видимы.
|
recordAutomatableEvent | () | метод |
public function recordAutomatableEvent(recorder:IAutomationObject, event:Event, cacheable:Boolean = false):void
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Записывает событие.
Параметры
recorder:IAutomationObject — Объект автоматизации, для которого следует записать событие.
| |
event:Event — Фактическое записываемое событие.
| |
cacheable:Boolean (default = false ) — Управляет кэшированием записываемого события. Во время последовательности «нажатие кнопки мыши, освобождение кнопки мыши» механизмом автоматизации выполняется попытка записать самое важное или подходящее событие, но не все события. Например, если в средствах визуализации элементов для элемента управления List находится кнопка. При нажатии кнопки пользователем механизмом автоматизации выполняется только запись события click для кнопки; созданное для элемента управления List событие select игнорируется.
|
recordCustomAutomationEvent | () | метод |
public function recordCustomAutomationEvent(customEvent:AutomationRecordEvent):Boolean
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Записывает пользовательское событие.
Параметры
customEvent:AutomationRecordEvent — - AutomationRecordEvent, который указывает пользовательское событие; тип - customRecord. Например, этот интерфейс может использоваться для записи пользовательского события без создания объекта-делегата и предоставления подробной информации в файле среды. Следует прослушать AutomationPlaybackEvent, обработать воспроизведение и предотвратить действия по умолчанию для AutomationPlaybackEvent.
|
Boolean |
replayAutomatableEvent | () | метод |
public function replayAutomatableEvent(event:AutomationReplayEvent):Boolean
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Воспроизводит указанное событие. Автор компонента должен вызвать метод super.replayAutomatableEvent()
в случае, если поведение воспроизведения по умолчанию определено в суперклассе.
Параметры
event:AutomationReplayEvent — Воспроизводимое событие.
|
Boolean — true при успешном воспроизведении.
|
resolveID | () | метод |
public function resolveID(rid:AutomationID, currentParent:IAutomationObject = null):Array
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Связывает идентификатор с объектами автоматизации.
Параметры
rid:AutomationID — Идентификатор автоматизации объекта автоматизации.
| |
currentParent:IAutomationObject (default = null ) — Текущий вышестоящий элемент для объекта автоматизации.
|
Array — Массив, содержащий все объекты, которые соответствуют rid .
|
resolveIDPart | () | метод |
public function resolveIDPart(parent:IAutomationObject, part:AutomationIDPart):Array
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Связывает идентификационную часть с массивом объектов автоматизации.
Параметры
parent:IAutomationObject — Вышестоящий элемент для объекта автоматизации.
| |
part:AutomationIDPart — идентификационная часть объекта автоматизации.
|
Array — Массив объектов автоматизации, которые соответствуют идентификатору part .
|
resolveIDPartToSingleObject | () | метод |
public function resolveIDPartToSingleObject(parent:IAutomationObject, part:AutomationIDPart):IAutomationObject
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Связывает идентификационную часть с объектом автоматизации в вышестоящем элементе.
Параметры
parent:IAutomationObject — Вышестоящий элемент для объекта автоматизации.
| |
part:AutomationIDPart — идентификационная часть объекта автоматизации.
|
IAutomationObject — IAutomationObject, который соответствует part . Если найдено несколько объектов или не найдено ни одного объекта, то выводится исключение.
|
resolveIDToSingleObject | () | метод |
public function resolveIDToSingleObject(rid:AutomationID, currentParent:IAutomationObject = null):IAutomationObject
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Связывает идентификатор с объектом автоматизации.
Параметры
rid:AutomationID — Идентификатор автоматизации объекта автоматизации.
| |
currentParent:IAutomationObject (default = null ) — Текущий вышестоящий элемент для объекта автоматизации.
|
IAutomationObject — IAutomationObject, который соответствует rid . Если найдено несколько объектов или не найдено ни одного объекта, то этот метод выводит исключение.
|
showInHierarchy | () | метод |
public function showInHierarchy(obj:IAutomationObject):Boolean
Язык версии: | ActionScript 3.0 |
Версия продукта: | Flex 3 |
Версии среды выполнения: | Flash Player 9, AIR 1.1 |
Указывает, является ли объект автоматизации видимым в иерархии автоматизации.
Параметры
obj:IAutomationObject — Объект автоматизации.
|
Boolean — Значение true , если объект автоматизации должен отображаться в иерархии автоматизации.
|
Tue Jun 12 2018, 11:34 AM Z