AccImpl  - AS3 Flex

Пакет	mx.accessibility
Класс	public class AccImpl
Наследование	AccImpl AccessibilityImplementation Object
Подклассы	AccordionHeaderAccImpl, ButtonAccImpl, ButtonBaseAccImpl, ComboBaseAccImpl, DateChooserAccImpl, DateFieldAccImpl, LabelAccImpl, ListBaseAccImpl, ListBaseAccImpl, MenuBarAccImpl, PanelAccImpl, PanelAccImpl, RichEditableTextAccImpl, SliderAccImpl, SliderBaseAccImpl, SpinnerAccImpl, TabBarAccImpl, TextBaseAccImpl, TreeAccImpl, VideoPlayerAccImpl

Язык версии:

ActionScript 3.0

Версия продукта:

Flex 3

Версии среды выполнения:

Flash Player 9, AIR 1.1

AccImpl является базовым классом реализации специальных возможностей Flex для компонентов MX и Spark.

Это подкласс класса AccessibilityImplementation Flash Player.

После создания компонента MX или Spark для его свойства accessibilityImplementation назначается экземпляр подкласса этого класса. Затем Flash Player использует этот объект, чтобы разрешить клиентам MSAA, например устройствам считывания с экрана, обнаруживать этот компонент и управлять им. См. описание класса flash.accessibility.AccessibilityImplementation для получения дополнительной информации о классах реализации специальных возможностей и MSAA.

Нижестоящие элементы

Flash Player не поддерживает истинную иерархию доступных объектов. Если DisplayObject имеет объект accessibilityImplementation, то объекты accessibilityImplementation его нижестоящих элементов игнорируются. Однако в Player класс реализации специальных возможностей компонента может отображать информацию MSAA для своих внутренних элементов. (Например, в списке представлена информация MSAA об элементах этого списка.)

Число нижестоящих элементов (внутренних элементов) и нижестоящих идентификаторов, используемых для их распознавания, определяется методом getChildIDArray(). В базовом классе AccessibilityImplementation Player этот метод возвращает null. Класс AccImpl Flex изменяет его, чтобы возвратить пустой массив. Он также предоставляет защищенный служебный метод createChildIDArray(), подклассы с внутренними элементами которого могут использоваться при заменах.

Роль

Роль MSAA для компонента и его внутренних элементов определяется методом get_accRole(). В базовом классе AccessibilityImplementation Player этот метод вызывает ошибку времени выполнения, поскольку ожидается, что подклассы должны ее изменить. Класс AccImpl Flex имеет защищенное свойство role, подклассы которого обычно устанавливаются в соответствующем конструкторе, при этом для возвращения этого свойства заменяется get_accRole().

Имя

Имя MSAA для компонента и его внутренних элементов определяется методом get_accName(). В базовом классе AccessibilityImplementation Player этот метод возвращает null. Класс AccImpl Flex изменяет его для создания имен следующим образом, начиная с пустой строки и разделяя добавленные части одиночным пробелом:

• При запросе простого нижестоящего элемента (например, элемента окна списка или комбинированного списка) возвращается только имя по умолчанию для нижестоящего элемента. Остальная часть шагов, описанных ниже, применяется только непосредственно к компоненту (childID 0).
• Если компонент находится внутри Form:
  • Если в форме присутствует FormHeading, находящийся внутри FormItem, добавляется текст заголовка. Во избежание этой ситуации разработчики должны установить для accessibilityName FormHeading пробел (" ").
  • Если это поле требуется, то добавляется зависящая от языкового стандарта строка «поле добавлено».
  • Если компонент находится внутри FormItem, добавляется текст метки FormItem. Во избежание этой ситуации разработчики должны установить для accessibilityName FormItem пробел (" ").
• Затем имя компонента определяется следующим образом:
  • Если компонент accessibilityName (то есть accessibilityProperties.name) является пробелом, имена компонентов не добавляются.
  • В ином случае компонент добавляется, если указано его имя (то есть если компонент не null и не пустой).
  • В ином случае для получения имени по умолчанию вызывается защищенный метод getName(), определенный AccImpl и внедренный каждым подклассом. (Например, ButtonAccImpl реализует getName() для указания того, что именем по умолчанию для Button является отображаемая метка.) Если не является пустым, добавляется возвращаемое значение getName().
  • В ином случае (если getName() вернул пустой элемент) добавляется строка, если установлено свойство toolTip компонента.
  • Если установлено свойство errorString компонента, то добавляется строка.

Описание

Описание MSAA определяется исключительно объектом accessibilityProperties компонента, а не его объектом accessibilityImplementation. Поэтому нелогично использовать AccessibilityImplementation или AccImpl, а также любые подклассы AccImpl, связанные с этим описанием. Обычно установка описания в Flex выполняется посредством свойства accessibilityDescription UIComponent, который просто устанавливает accessibilityProperties.description.

Состояние

Состояние MSAA для компонента и его внутренних элементов определяется методом get_accState(). В базовом классе AccessibilityImplementation Player этот метод вызывает ошибку времени выполнения, поскольку ожидается, что подклассы должны ее изменить. Класс AccImpl Flex не изменяет его, но предоставляет защищенный служебный метод getState() для подклассов для использования при заменах. Метод getState() определяет состояние в виде сочетания

• STATE_SYSTEM_UNAVAILABLE (если включено = false для данного компонента или его предка)
• STATE_SYSTEM_FOCUSABLE
• STATE_SYSTEM_FOCUSED (когда фокус находится непосредственно на компоненте и не установлен на подчиненных элементах компонента)

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

Значение

Значение MSAA для компонента и его внутренних элементов определяется методом get_accValue(). В базовом классе AccessibilityImplementation Player этот метод возвращает null. Класс AccImpl Flex не изменяет его в отличие от подклассов для таких компонентов, как TextInput.

Расположение

Местоположение MSAA для внутренних элементов компонента, но не самого компонента, определяется методом get_accLocation(). Этот метод никогда не вызывается с childID 0; вместо этого Flash Player определяет местоположение MSAA компонента на основе его ограничительного прямоугольника в соответствии с getBounds(). Класс AccImpl Flex не изменяет этот метод в отличие от подклассов для компонентов с внутренними элементами.

Действие по умолчанию

Действие по умолчанию MSAA для компонента и его внутренних элементов определяется методом get_accDefaultAction(). В базовом классе AccessibilityImplementation Player этот метод возвращает null. Класс AccImpl Flex не изменяет его в отличие от подклассов с действиями по умолчанию. Эти подклассы также изменяют метод accDoDefaultAction() AccessibilityImplementation для выполнения действия по умолчанию, которое они предоставляют.

Другие

События MSAA EVENT_OBJECT_SHOW и EVENT_OBJECT_HIDE отправляются, когда объект показан или скрыт. Соответствующие состояния для них включены в Flash Player, который не выполняет визуализацию скрытых компонентов MSAA. При отображении компонента используются состояния, указанные для AccImpl.

---