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

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

Разработчик

Ссылка класса UIAccessibilityElement

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

На этой странице
Язык:

UIAccessibilityElement

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

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

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

Swift

import UIKit

Objective C

@import UIKit;

Доступность

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

UIAccessibilityElement класс инкапсулирует информацию об элементе, который должен быть доступен для пользователей с ограниченными возможностями, но это не доступно по умолчанию. Например, значок или текстовое изображение не автоматически доступны, потому что это не наследовалось от UIView (или UIControl). Представление, содержащее такие элементы непредставления, создает экземпляр UIAccessibilityElement представлять каждый элемент, который должен быть доступным.

Свойства элемента доступности предоставляют информацию об элементе, таком как расположение и текущая стоимость, к вспомогательному приложению. Даже если Вы не должны создавать экземпляр, Вы, возможно, должны были бы установить свойство элемента UIAccessibilityElement представлять его. Например, если Ваше приложение включает кнопку с пользовательским значком, означающим, «решают», сама кнопка уже представлена элементом доступности, потому что это - подкласс UIButton. Однако необходимо предоставить информацию для метки и свойств подсказки, потому что эта информация уникальна для этой кнопки. Можно сделать это в Интерфейсном Разработчике или путем установки свойств в UIAccessibility неофициальный протокол.

Создание элемента доступности
  • init (accessibilityContainer:) - initWithAccessibilityContainer:

    Создает и инициализирует элемент доступности для представления элемента в указанном контейнере.

    Объявление

    Swift

    init(accessibilityContainer container: AnyObject)

    Objective C

    - (instancetype)initWithAccessibilityContainer:(id)container

    Параметры

    container

    Представление, содержащее элемент.

    Возвращаемое значение

    Элемент доступности для представления элемента непредставления в контейнере.

    Обсуждение

    В целом Вы не создаете элементы доступности для элементов в Вашем приложении, потому что стандартные средства управления UIKit и представления доступны по умолчанию. Однако, если у Вас есть представление, содержащее элементы непредставления, такие как значки или текстовые изображения, которые должны быть доступны для пользователей с ограниченными возможностями, Вы создаете элементы доступности для представления их. В этом случае содержание представления должно реализовать UIAccessibilityContainer неофициальный протокол и использование этот метод для создания элемента доступности для представления каждого элемента, который должен быть представлен вспомогательному приложению.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

Доступ к содержанию представления
  • accessibilityContainer Свойство

    Представление, содержащее элемент доступности.

    Объявление

    Swift

    unowned(unsafe) var accessibilityContainer: AnyObject

    Objective C

    @property(nonatomic, assign) id accessibilityContainer

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

Определение доступности
  • isAccessibilityElement Свойство

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

    Объявление

    Swift

    var isAccessibilityElement: Bool

    Objective C

    @property(nonatomic, assign) BOOL isAccessibilityElement

    Обсуждение

    Значение по умолчанию для этого свойства NOfalse. Если получатель является управлением UIKit, значение по умолчанию YEStrue.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

Доступ к атрибутам элемента доступности
  • accessibilityLabel Свойство

    Строка, кратко идентифицирующая элемент доступности.

    Объявление

    Swift

    var accessibilityLabel: String?

    Objective C

    @property(nonatomic, retain) NSString *accessibilityLabel

    Обсуждение

    Метка является очень короткой, локализованной строкой, идентифицирующей элемент доступности, но не включающей тип управления или представления. Например, меткой для кнопки Save является «Сохранение», не “Кнопка Save”.

    По умолчанию стандартные средства управления UIKit и представления имеют метки, происходящие из их заголовков. При обеспечении пользовательского элемента управления или представления, однако, необходимо установить это свойство соответственно так, чтобы вспомогательные приложения могли предоставить точную информацию пользователям с ограниченными возможностями.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

  • accessibilityHint Свойство

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

    Объявление

    Swift

    var accessibilityHint: String?

    Objective C

    @property(nonatomic, retain) NSString *accessibilityHint

    Обсуждение

    Подсказка является кратким, локализованным описанием результата выполнения действия с элементом, не идентифицируя элемент или действие. Например, подсказка для строки таблицы, содержащей электронное письмо, могла бы быть, “Выбирает сообщение”, но не “Касаются этой строки для выбора сообщения”.

    По умолчанию стандартные средства управления UIKit и представления были предоставлены системой подсказки. При обеспечении пользовательского элемента управления или представления, однако, необходимо установить это свойство соответственно так, чтобы вспомогательные приложения могли предоставить точную информацию пользователям с ограниченными возможностями.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

  • accessibilityValue Свойство

    Строка, представляющая текущую стоимость элемента доступности.

    Объявление

    Swift

    var accessibilityValue: String?

    Objective C

    @property(nonatomic, retain) NSString *accessibilityValue

    Обсуждение

    Значение является локализованной строкой, содержащей текущую стоимость элемента. Например, значение ползунка могло бы быть 9.5 или 35%, и значение текстового поля является текстом, который это содержит.

    Используйте свойство значения только, когда элемент доступности может иметь значение, не представленное его меткой. Например, меткой регулятора громкости мог бы быть «Объем», но его значение является текущим уровнем громкости. В этом случае это недостаточно для пользователей для знания идентификационных данных ползунка, потому что они также должны знать его текущую стоимость. Метка кнопки Save, с другой стороны, говорит пользователям все, что они должны знать об управлении; при предоставлении слова «Save», поскольку значение было бы ненужным и запутывающим.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

  • accessibilityFrame Свойство

    Кадр элемента доступности, в координатах экрана.

    Объявление

    Swift

    var accessibilityFrame: CGRect

    Objective C

    @property(nonatomic, assign) CGRect accessibilityFrame

    Обсуждение

    При создании элемента доступности для представления элемента в приложении, необходимо установить это свойство в CGRect структура, указывающая расположение на экране и размер объекта. (Объекты, наследовавшиеся от UIView включайте эту информацию по умолчанию.)

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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

    См. также

    UIAccessibilityConvertFrameToScreenCoordinates

  • accessibilityTraits Свойство

    Комбинация черт, лучше всего характеризующих элемент доступности.

    Объявление

    Swift

    var accessibilityTraits: UIAccessibilityTraits

    Objective C

    @property(nonatomic, assign) UIAccessibilityTraits accessibilityTraits

    Обсуждение

    Черта описывает единственный аспект поведения элемента, состояния или использования. Несколько черт объединены в этом свойстве (использующий операцию OR) для предоставления полного изображения элемента к вспомогательному приложению. См. “Черты Доступности” в Ссылке на протокол UIAccessibility для полного списка черт.

    UIKit обеспечивает надлежащую комбинацию черт для всех стандартных средств управления и представлений. При объединении черт для пользовательского элемента доступности, быть уверенным:

    • Используйте здравый смысл. Не комбинируйте черты, характеризующие элемент взаимоисключающими способами, такими как объединение черты поля поиска и кнопка.

    • Объедините черты, которые Вы выбираете с чертами суперкласса. В частности всегда комбинируйте свои пользовательские черты с [super accessibilityTraits] в методе Вы используете для установки черт пользовательского элемента.

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

    Objective C

    @import UIKit;

    Swift

    import UIKit

    Доступность

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