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

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

Разработчик

Ссылка класса UIAElementArray

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

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

UIAElementArray

Наследование


Не применимый

Соответствует


Не применимый

Оператор импорта


Не применимый не применимый

Доступность


Доступный в iOS 4.0 и позже.

UIAElementArray класс поддерживает операции с массивами, содержащими многократные объекты UIAElement. Можно искать массив по имени или пары ключ/значение, или по пользовательским критериям, что Вы указываете использование предиката. Для получения дальнейшей информации об использовании предикатов, см. Руководство по программированию Предикатов.

UIAElementArray поддерживает традиционный краткий синтаксис для доступа к элементам в собственных объектах JavaScript:

  • отметьте точкой ссылку именем элемента, например:

    var okButton = buttons.OK;

  • ссылка скобки индексом, например:

    var firstElement = elements[0];

  • ссылка скобки именем элемента, например:

    var helloWorldText = staticTexts["Hello World"];

Важно отметить то, потенциально путающее ограничение в использовании ссылок скобки именем элемента. Если бы имя элемента, оказалось, было числом, то JavaScript интерпретировал бы то имя как индекс, вероятно приведя к неправильным результатам. Например, рассмотрите этот массив:

var elements = ["DoIt", "Cancel", "1"];

При попытке получить доступ к третьему элементу по имени со справочным синтаксисом скобки:

elements()["1"]

это фактически обрабатывается как ссылка на первый элемент, приводя к первому элементу (названный «Мелкой монетой») вместо этого. В случаях, где эта проблема могла бы произойти, необходимо использовать точечный справочный синтаксис вместо этого:

elements().firstWithName("1")

Для объяснения того, как использовать этот класс и связанные классы, посмотрите Автоматизацию Тестирование UI в Инструментальном Руководстве пользователя.

  • length Свойство

    Возвращает число элементов пользовательского интерфейса в массиве.

    Объявление

    JavaScript

    (Number) length

  • Возвращает первый элемент в массиве с этим именем.

    Объявление

    JavaScript

    (UIAElement) firstWithName(String name)

    Параметры

    name

    Строка, значение которой является именем соответствия элемента на.

    Доступность

    Доступный в iOS 4.0 и позже.

  • Возвращает первый элемент в массиве, соответствующем данные критерии.

    Объявление

    JavaScript

    (UIAElement) firstWithPredicate(PredicateString predicateString)

    Параметры

    predicateString

    Предикат, указывающий критерии для соответствия.

    Обсуждение

    Для получения дальнейшей информации о соответствии предиката, см. Руководство по программированию Предиката.

    Доступность

    Доступный в iOS 4.0 и позже.

  • Возвращает первый элемент в массиве со значением, соответствующим ключ свойства.

    Объявление

    JavaScript

    (UIAElement) firstWithValueForKey(NotTyped value, String key)

    Доступность

    Доступный в iOS 4.0 и позже.

  • Преобразовывает массив в стандартный массив JavaScript.

    Объявление

    JavaScript

    (Array) toArray()

    Доступность

    Доступный в iOS 4.0 и позже.

  • Возвраты все элементы в массиве с этим именем.

    Объявление

    JavaScript

    (UIAElementArray) withName(String name)

    Доступность

    Доступный в iOS 4.0 и позже.

  • Возвраты все элементы в массиве, соответствующем данный.

    Объявление

    JavaScript

    (UIAElementArray) withPredicate(PredicateString predicateString)

    Обсуждение

    Предикат, соответствующий, соблюдает те же правила как NSPredicate.

    Доступность

    Доступный в iOS 4.0 и позже.

  • Возвраты все элементы в массиве со значением, соответствующим ключ свойства.

    Объявление

    JavaScript

    (UIAElementArray) withValueForKey(NotTyped value, String key)

    Параметры

    value

    Строка, указывающая значение, что указанное свойство, если это существует, должна соответствовать.

    key

    Строка, указывающая свойство для тестирования на.

    Доступность

    Доступный в iOS 4.0 и позже.

Константы

  • Объявление

    Константы

    • UIAElementNil

      Возвращенный функцией с типом возврата UIAElement или UIAElementArray если требуемый элемент не доступен после timeout льготный период Вы указываете. Даже если промежуточная функция в выражении перестала работать временно в течение льготного периода, этот механизм позволяет Вашим выражениям сценариев завершаться. Например, если панель навигации не существует, следующий код не повышает исключение; вместо этого это возвращается UIAElementNil.

      • var backButton = UIATarget.localTarget().frontMostApp().navigationBar().buttons()["Back"];
      • if (backButton.isValid()) {
      • backButton.tap();
      • } else {
      • UIALogger.logError("Could not find 'Back' button!");
      • }

      Доступный в iOS 4.0 и позже.