Spec-Zone .ru
спецификации, руководства, описания, API

Библиотека Разработчика iOS

Разработчик

Ссылка класса UIAElement

Опции
Развертывание Target:

На этой странице

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 для ON 0 для 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 и позже.