UIAElement
Наследование
Не применимый
Соответствует
Не применимый
Оператор импорта
Не применимый не применимый
Доступность
Доступный в iOS 4.0 и позже.
UIAElement
класс является суперклассом для всех элементов пользовательского интерфейса в контексте инструмента Автоматизации для автоматизации тестирования пользовательского интерфейса приложений для iOS.
Для объяснения того, как использовать этот класс и связанные классы, посмотрите Автоматизацию Тестирование UI в Инструментальном Руководстве пользователя.
-
Возвращает экранную позицию для ответвления для указанного элемента.
Объявление
JavaScript
(Point) hitpoint()
Доступность
Доступный в iOS 4.0 и позже.
-
Возвращает позицию объекта на основном экране.
Объявление
JavaScript
(Rect) rect()
Обсуждение
Ваш сценарий должен обработать
rect
возразите как универсальный объект JavaScript, свойства которого для источника, x, y, размера, ширины и высоты соответствуют тем из аналогичной структуры Какао CGRect. Объект rect имеет форму{origin:{x:
xposition,y:
yposition}, size:{width:
widthvalue, height:
heightvalue}}
. Соответствующие координаты относительны экраном и корректируются для учета ориентации устройства.Доступность
Доступный в iOS 4.0 и позже.
-
Возвращает массив индикаторов действия, содержавших указанным объектом.
Объявление
JavaScript
(UIAElementArray) activityIndicators()
Доступность
Доступный в iOS 4.0 и позже.
-
Возвращает объект, представляющий представление действия.
Объявление
JavaScript
(UIAActivityView) activityView()
Доступность
Доступный в iOS 6.0 и позже.
-
Возвращает массив, содержащий родителей указанного объекта.
Объявление
JavaScript
(UIAElementArray) ancestry()
Доступность
Доступный в iOS 4.0 и позже.
-
Возвращает массив кнопок, содержавших указанным объектом.
Объявление
JavaScript
(UIAElementArray) buttons()
Доступность
Доступный в iOS 4.0 и позже.
-
Возвращает массив представлений набора, содержавших указанным объектом.
Объявление
JavaScript
(UIAElementArray collectionViews()
Доступность
Доступный в iOS 6.0 и позже.
-
Возвращает массив элементов, содержавших указанным объектом.
Объявление
JavaScript
(UIAElementArray) elements()
Доступность
Доступный в iOS 4.0 и позже.
-
Возвращает массив изображений, содержавших указанным объектом.
Объявление
JavaScript
(UIAElementArray) images()
Доступность
Доступный в iOS 4.0 и позже.
-
Возвращает массив ссылок, содержавших указанным объектом.
Объявление
JavaScript
(UIAElementArray) links()
Доступность
Доступный в iOS 4.0 и позже.
-
Возвращает панель навигации приложения.
Объявление
JavaScript
(UIAElement) navigationBar()
Обсуждение
Этот метод был перемещен до этого класса от Класса UIAWindow.
Доступность
Доступный в iOS 4.0 и позже.
-
Возвращает массив объектов панели навигации, содержавших этим объектом.
Объявление
JavaScript
(UIAElementArray) navigationBars()
Обсуждение
Этот метод был перемещен до этого класса от Класса UIAWindow.
Доступность
Доступный в iOS 4.0 и позже.
-
Возвращает массив индикаторов страницы, содержавших указанным объектом.
Объявление
JavaScript
(UIAElementArray) pageIndicators()
Доступность
Доступный в iOS 4.0 и позже.
-
Возвращает родителя указанного элемента.
Объявление
JavaScript
(UIAElement) parent()
Доступность
Доступный в iOS 4.2 и позже.
-
Возвращает массив объектов средства выбора, содержавших указанным объектом.
Объявление
JavaScript
(UIAElementArray) pickers()
Доступность
Доступный в iOS 4.0 и позже.
-
Возвращает объект легкой сдобы, связанный с указанным объектом, если Вы существуете.
Объявление
JavaScript
(UIAPopover) popover()
Доступность
Доступный в iOS 4.2 и позже.
-
Возвращает массив индикаторов хода выполнения, содержавших указанным объектом.
Объявление
JavaScript
(UIAElementArray) progressIndicators()
Доступность
Доступный в iOS 4.0 и позже.
-
Возвращает массив представлений прокрутки, содержавших указанным объектом.
Объявление
JavaScript
(UIAElementArray) scrollViews()
Доступность
Доступный в iOS 4.0 и позже.
-
Возвращает массив панелей поиска, содержавших указанным объектом.
Объявление
JavaScript
(UIAElementArray) searchBars()
Доступность
Доступный в iOS 4.0 и позже.
-
Возвращает массив безопасных текстовых полей, содержавших указанным объектом.
Объявление
JavaScript
(UIAElementArray) secureTextFields()
Доступность
Доступный в iOS 4.0 и позже.
-
Возвращает массив сегментированных средств управления, содержавших указанным объектом.
Объявление
JavaScript
(UIAElementArray) segmentedControls()
Доступность
Доступный в iOS 4.0 и позже.
-
Возвращает массив ползунков, содержавших указанным объектом.
Объявление
JavaScript
(UIAElementArray) sliders()
Доступность
Доступный в iOS 4.0 и позже.
-
Возвращает массив статических текстов, содержавших указанным объектом.
Объявление
JavaScript
(UIAElementArray) staticTexts()
Доступность
Доступный в iOS 4.0 и позже.
-
Возвращает массив переключателей, содержавших указанным объектом.
Объявление
JavaScript
(UIAElementArray) switches()
Доступность
Доступный в iOS 4.0 и позже.
-
Возвращает указанную панель вкладок.
Объявление
JavaScript
(UIAElement) tabBar()
Обсуждение
Этот метод был перемещен до этого класса от Класса UIAWindow.
Доступность
Доступный в iOS 4.0 и позже.
-
Возвращает массив панелей вкладок, содержавших этим объектом.
Объявление
JavaScript
(UIAElementArray) tabBars()
Обсуждение
Этот метод был перемещен до этого класса от Класса UIAWindow.
Доступность
Доступный в iOS 4.0 и позже.
-
Возвращает массив табличных представлений, содержавших указанным объектом.
Объявление
JavaScript
(UIAElementArray) tableViews()
Доступность
Доступный в iOS 4.0 и позже.
-
Возвращает массив текстовых полей, содержавших указанным объектом.
Объявление
JavaScript
(UIAElementArray) textFields()
Доступность
Доступный в iOS 4.0 и позже.
-
Возвращает массив текстовых представлений, содержавших указанным объектом.
Объявление
JavaScript
(UIAElementArray) textViews()
Доступность
Доступный в iOS 4.0 и позже.
-
Возвращает указанную панель инструментов.
Объявление
JavaScript
(UIAElement) toolbar()
Обсуждение
Этот метод был перемещен до этого класса от Класса UIAWindow.
Доступность
Доступный в iOS 4.0 и позже.
-
Возвращает массив панелей инструментов, содержавших этим объектом.
Объявление
JavaScript
(UIAElementArray) toolbars()
Обсуждение
Этот метод был перемещен до этого класса от Класса UIAWindow.
Доступность
Доступный в iOS 4.0 и позже.
-
Возвращает массив веб-представлений, содержавших указанным объектом.
Объявление
JavaScript
(UIAElementArray) webViews()
Доступность
Доступный в iOS 4.0 и позже.
Эти методы позволяют Вам производить общие жесты и действия, которые пользователь может выполнить через пользовательский интерфейс. Опции доступны для использования с некоторыми из этих методов, чтобы дать Вам гибкость в определении и варьировании атрибуты жеста или действия, которое будет выполняться.
-
Двойные касания указанный элемент.
Объявление
JavaScript
(undefined) doubleTap()
Доступность
Доступный в iOS 4.0 и позже.
-
Перетаскивает в границах элемента.
Объявление
JavaScript
(undefined) dragInsideWithOptions(Object options)
Параметры
options
Словарь, указывающий характеристики жеста. Допустимые ключи следующие:
touchCount
Число касаний для использования в указанном жесте. (Эффективно, число пальцев пользователь использовало бы для создания указанного жеста.) Сенсорное значение количества по умолчанию равняется 1.
duration
Длина времени задержки для указанного жеста. Значение продолжительности по умолчанию для касания 0. Значение по умолчанию для жестов касаться-и-содержать (тех, которые перетаскивают, зажмите открытый, и зажмите близко), 1.
startOffset
Первое смещение, которое будет использовать для жеста многократной точки. Значение по умолчанию {x:0.0, y:0.0}. Посмотрите обсуждение для подробных данных.
endOffset
Последнее смещение, которое будет использовать для жеста многократной точки. Значение по умолчанию {x:0.0, y:0.0}. Посмотрите обсуждение для подробных данных.
Обсуждение
Можно использовать смещения для достижения более прекрасной точности в указании hitpoint в
rect
для указанного элемента. Смещение включает пару значений x и y, каждого в пределах от 0,0 к 1,0. Эти значения представляют, соответственно, относительные горизонтальные и вертикальные позиции вrect
, с {x:0.0, y:0.0} как верхнее левое и {x:1.0, y:1.0} как нижнее правое. Таким образом, {x:0.3, y:0.6} указывает, что позиция чуть ниже и налево от центра, и {x:1.0, y:0.5} указывает позицию, центрируемую вертикально в далеком праве.Этот пример выполняет медленное перетаскивание в целевом элементе от левого края до правого края, чуть ниже вершины:
target.dragInsideWithOptions({startOffset:{x:0.0, y:0.1}, endOffset:{x:1.0, y:0.1}, duration:1.5});
Доступность
Доступный в iOS 4.0 и позже.
-
Щелчки в границах элемента.
Объявление
JavaScript
(undefined) flickInsideWithOptions(Object options)
Параметры
options
Словарь, указывающий характеристики жеста. Допустимые ключи следующие:
touchCount
Число касаний для использования в указанном жесте. (Эффективно, число пальцев пользователь использовало бы для создания указанного жеста.) Сенсорное значение количества по умолчанию равняется 1.
startOffset
Первое смещение, которое будет использовать для жеста многократной точки. Значение по умолчанию {x:0.0, y:0.0}. Посмотрите обсуждение для подробных данных.
endOffset
Последнее смещение, которое будет использовать для жеста многократной точки. Значение по умолчанию {x:0.0, y:0.0}. Посмотрите обсуждение для подробных данных.
Обсуждение
Можно использовать смещения для достижения более прекрасной точности в указании hitpoint в
rect
для указанного элемента. Смещение включает пару значений x и y, каждого в пределах от 0,0 к 1,0. Эти значения представляют, соответственно, относительные горизонтальные и вертикальные позиции вrect
, с {x:0.0, y:0.0} как верхнее левое и {x:1.0, y:1.0} как нижнее правое. Таким образом, {x:0.3, y:0.6} указывает, что позиция чуть ниже и налево от центра, и {x:1.0, y:0.5} указывает позицию, центрируемую вертикально в далеком праве.Этот пример выполняет щелчок чуть выше базового края целевого элемента от центра до правого края:
target.flickInsideWithOptions({startOffset:{x:0.5, y:0.9}, endOffset:{x:1.0, y:0.9}});
Доступность
Доступный в iOS 4.0 и позже.
-
Выполните жест вращения, центрируемый на указанном элементе.
Объявление
JavaScript
(undefined) rotateWithOptions(Object options)
Параметры
options
Словарь, указывающий характеристики жеста вращения. Допустимые ключи следующие:
centerOffset
Смещение для использования для центра поворачивать жеста. Значение смещения по умолчанию {x:0.0, y:0.0}.
duration
Длина времени задержки для указанного жеста, в секундах. Значение продолжительности по умолчанию равняется 1.
radius
Расстояние в точках от центра до края кругового пути.
rotation
Продолжительность вращения в радианах. Значение по умолчанию является пи (π).
touchCount
Число касаний для использования в указанном жесте. (Эффективно, число пальцев пользователь использовало бы для создания указанного жеста.) Допустимые значения равняются 1 - 5. Значение по умолчанию равняется 2.
Обсуждение
Этот жест сгенерирован таким образом, что каждое касание является равноотстоящим от других.
Доступность
Доступный в iOS 4.0 и позже.
-
Прокрутки до указанного элемента видимы в контейнерном представлении.
Объявление
JavaScript
(undefined) scrollToVisible()
Обсуждение
Используйте этот метод с таблицами и веб-представлениями.
Доступность
Доступный в iOS 4.0 и позже.
-
Касается указанного элемента.
Объявление
JavaScript
(undefined) tap()
Доступность
Доступный в iOS 4.0 и позже.
-
Выполняет указанный жест на указанном элементе с помощью словаря для указания атрибутов жеста.
Объявление
JavaScript
(undefined) tapWithOptions(Object options)
Параметры
options
Словарь, указывающий характеристики жеста. Допустимые ключи следующие:
tapCount
Число касаний, составляющих указанный жест. Значение по умолчанию равняется 1 (единственное касание).
touchCount
Число касаний для использования в указанном жесте. (Эффективно, число пальцев пользователь использовало бы для создания указанного жеста.) Сенсорное значение количества по умолчанию равняется 1.
duration
Длина времени задержки для указанного жеста. Значение продолжительности по умолчанию для касания 0. Значение по умолчанию для жестов касаться-и-содержать (тех, которые перетаскивают, зажмите открытый, и зажмите близко), 1.
tapOffset
Смещение для использования для указанного жеста касания. Значение смещения по умолчанию {x:0.0, y:0.0}. Посмотрите обсуждение для подробных данных.
Обсуждение
Например, Вы могли указать тройное касание с двумя пальцами в центре экрана (на iPhone в портретной ориентации), следующим образом:
element.tapWithOptions({touchCount:2, tapCount:3});
element.tapWithOptions({touchCount:2, tapCount:3, tapOffset:{x:0.75, y:0.25}});
Можно использовать смещения для достижения более прекрасной точности в указании hitpoint в
rect
для указанного элемента. Смещение включает пару значений x и y, каждого в пределах от 0,0 к 1,0. Эти значения представляют, соответственно, относительные горизонтальные и вертикальные позиции вrect
, с {x:0.0, y:0.0} как верхнее левое и {x:1.0, y:1.0} как нижнее правое. Таким образом, {x:0.3, y:0.6} указывает, что позиция чуть ниже и налево от центра, и {x:1.0, y:0.5} указывает позицию, центрируемую вертикально в далеком праве.Доступность
Доступный в iOS 4.0 и позже.
-
Касается указанного элемента и содержит на указанное время.
Объявление
JavaScript
(undefined) touchAndHold(Number duration)
Параметры
duration
Отрезок времени для содержания касания к элементу, в секундах. Значение продолжительности по умолчанию для касания 0. Значение по умолчанию для жестов касаться-и-содержать (тех, которые перетаскивают, зажмите открытый, и зажмите близко), 1.
Доступность
Доступный в iOS 4.0 и позже.
-
Выполняет касание (с двумя касаниями) с двумя пальцами на этом элементе.
Объявление
JavaScript
(undefined) twoFingerTap()
Доступность
Доступный в iOS 4.0 и позже.
Используйте эти методы, чтобы определить, допустим ли элемент все еще.
-
Возвращает текущее состояние законности указанного элемента.
Объявление
JavaScript
(Boolean) checkIsValid()
Обсуждение
Используйте этот метод, чтобы определить, существует ли в настоящее время элемент пользовательского интерфейса, представленный указанным UIAElement. Необходимо использовать
checkIsValid
, например, если Вы ссылаетесь на элемент, выполнив некоторое действие, которое, возможно, изменило состояние UI того элемента в некотором роде. Это требует, чтобы вызов к базовой платформе Доступности гарантировал законность результата.Доступность
Доступный в iOS 4.0 и позже.
См. также
isValid
-
Определяет, получает ли указанный элемент ввод с клавиатуры.
Объявление
JavaScript
(Number) hasKeyboardFocus()
Возвращаемое значение
Возвраты 1, если указанный элемент является получателем ввода с клавиатуры, 0 если нет. Если состояние не доступно, оно возвращает нуль.
Доступность
Доступный в iOS 4.0 и позже.
-
Определяет, включен ли указанный элемент.
Объявление
JavaScript
(Number) isEnabled()
Возвращаемое значение
Возвраты 1, если указанный элемент включен, 0 если нет. Если состояние не доступно, оно возвращает нуль.
Доступность
Доступный в iOS 4.0 и позже.
-
Возвращает состояние законности указанного элемента с нового доступа.
Объявление
JavaScript
(Boolean) isValid()
Обсуждение
Используйте этот метод, чтобы определить, существовал ли элемент пользовательского интерфейса, представленный указанным UIAElement, с последней попытки получить доступ к нему. Чтобы быть уверенным, что элемент существует, использовать
checkIsValid
вместо этого.Доступность
Доступный в iOS 4.0 и позже.
См. также
checkIsValid
-
Определяет, видим ли указанный элемент на экране.
Объявление
JavaScript
(Number) isVisible()
Возвращаемое значение
Возвраты 1, если элемент пользовательского интерфейса, представленный указанным элементом, видим на экране, 0 если нет. Если состояние не доступно, оно возвращает нуль.
Доступность
Доступный в iOS 4.0 и позже.
-
Ожидает указанного элемента для становления недопустимым.
Объявление
JavaScript
(Boolean) waitForInvalid()
Обсуждение
Ожидает элемента пользовательского интерфейса, представленного указанным UIAElement для становления недопустимым. Использует ток
timeout
значение для интервала времени ожидания.Доступность
Доступный в iOS 4.0 и позже.
-
Возвращает строку, содержащую атрибут метки элемента.
Объявление
JavaScript
(String) label()
Обсуждение
Этот метод всегда возвращает строку атрибута метки. (Контраст с
name
метод.)Доступность
Доступный в iOS 5.0 и позже.
-
Возвращает строку, содержащую атрибут имени элемента.
Объявление
JavaScript
(String) name()
Обсуждение
Имя элемента получено из атрибута доступности базового представления. Если строка атрибута идентификатора указана, та строка используется в качестве имени; иначе, строка атрибута метки используется в качестве имени. Контраст с
label
метод.Для получения дополнительной информации посмотрите Ссылку на протокол UIAccessibilityIdentification.
Доступность
Доступный в iOS 4.0 и позже.
-
Возвращается строка, содержащая значение, приписывают определенный для типа элемента.
Объявление
JavaScript
(String) value()
Обсуждение
Например, переключатель имеет значение
1
для ON0
для OFF.Доступность
Доступный в iOS 4.0 и позже.
-
Возвращает элемент, атрибут имени которого соответствует указанную строку.
Объявление
JavaScript
(UIAElement) withName(String name)
Параметры
name
Строка, содержащая имя для тестирования на.
Обсуждение
Тесты, если атрибут имени элемента имеет данное строковое значение. Если соответствие перестало работать, тест повторен до тока
timeout
истекает.Доступность
Доступный в iOS 4.0 и позже.
-
Возвращает элемент, соответствующий указанные критерии.
Объявление
JavaScript
(UIAElement) withPredicate(PredicateString predicateString)
Параметры
predicateString
Строка, указывающая критерии соответствия.
Обсуждение
Использует указанную строку предиката для тестирования на соответствие. Если соответствие перестало работать, тест повторен до тока
timeout
истекает. См. Руководство по программированию Предиката для получения информации об использовании предикатов.Доступность
Доступный в iOS 4.0 и позже.
-
Возвращает элемент, содержащий указанное свойство с указанным значением.
Объявление
JavaScript
(UIAElement) withValueForKey(NotTyped value, String key)
Параметры
value
Строка, указывающая значение, что указанное свойство, если это существует, должна соответствовать.
key
Строка, указывающая свойство для тестирования на.
Обсуждение
Тесты, если элемент имеет указанное свойство с указанным значением. Если соответствие перестало работать, тест повторен до тока
timeout
истекает.Доступность
Доступный в iOS 4.0 и позже.
-
Информация о журналах об указанном элементе.
Объявление
JavaScript
(undefined) logElement()
Обсуждение
Этот метод может использоваться с любым элементом.
Доступность
Доступный в iOS 4.0 и позже.
-
Информация о журналах об указанном элементе и всех его подэлементах.
Объявление
JavaScript
(undefined) logElementTree()
Обсуждение
Этот метод может использоваться с любым элементом.
Доступность
Доступный в iOS 4.0 и позже.