Пакет javax.accessibility

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

Пакет API доступности Java состоит из 8 интерфейсов языка программирования Java и 6 классов языка программирования Java. Они описаны ниже.

Интерфейс Accessible

Интерфейс Accessible является основным интерфейсом API доступности Java. Все компоненты, поддерживающие API доступности Java, должны реализовывать этот интерфейс. Он содержит один метод, getAccessibleContext, который возвращает экземпляр класса AccessibleContext. Sun считает, что реализация этого интерфейса является абсолютным минимальным требованием для каждого объекта, являющегося частью пользовательского интерфейса Java-приложения, если это приложение должно быть совместимым с технологиями вспомогательных средств.

Класс AccessibleContext

AccessibleContext представляет минимальную информацию, которую все доступные объекты возвращают, и которая получается при вызове метода getAccessibleContext на объекте, реализующем интерфейс Accessible. Эта информация включает доступное имя, описание, роль и состояние объекта, а также информацию об объекте-родителе и дочерних объектах. Кроме того, также включена поддержка изменения свойств JavaBeans™, чтобы позволить технологиям вспомогательных средств узнать, когда изменяются значения доступных свойств. AccessibleContext также содержит методы получения более конкретной информации о доступности компонента. Если компонент её поддерживает, эти методы вернут объект, реализующий один или несколько из следующих интерфейсов:

• AccessibleAction - объект может выполнять одно или несколько действий. Этот интерфейс предоставляет стандартный механизм для технологии вспомогательных средств определить, какими являются эти действия, и сказать объекту выполнить эти действия. Любой объект, который может быть изменён, должен возвращать объект, реализующий этот интерфейс, когда вызывается метод getAccessibleAction в AccessibleContext.
• AccessibleComponent - объект имеет графическое представление. Этот интерфейс предоставляет стандартный механизм для технологии вспомогательных средств определить и установить графическое представление объекта. Любой объект, отображаемый на экране, должен возвращать объект, реализующий этот интерфейс, когда вызывается метод getAccessibleComponent в AccessibleContext.
• AccessibleSelection - объект позволяет выбирать своих дочерних элементов. Этот интерфейс предоставляет стандартный механизм для технологии вспомогательных средств определить текущих выбранных дочерних элементов, а также изменить набор выбора. Любой объект, у которого есть дочерние элементы, которые можно выбрать, должен возвращать объект, реализующий этот интерфейс, когда вызывается метод getAccessibleSelection в AccessibleContext.
• AccessibleText - объект представляет редактируемую текстовую информацию на дисплее. Этот интерфейс предоставляет стандартный механизм для технологии вспомогательных средств получить доступ к этому тексту через его содержимое, атрибуты и пространственное расположение. Любой объект, содержащий редактируемый текст, должен возвращать объект, реализующий этот интерфейс, когда вызывается метод getAccessibleText в AccessibleContext.
• AccessibleHypertext - объект представляет гипертекстовую информацию на дисплее. Этот интерфейс предоставляет стандартный механизм для технологии вспомогательных средств получить доступ к этому гипертексту через его содержимое, атрибуты и пространственное расположение. Любой объект, содержащий гипертекст, должен возвращать объект, реализующий этот интерфейс, когда вызывается метод getAccessibleText в AccessibleContext.
• AccessibleValue - объект поддерживает числовое значение. Этот интерфейс предоставляет стандартный механизм для технологии вспомогательных средств определить и установить текущее значение объекта, а также минимальное и максимальное значения. Любой объект, поддерживающий числовое значение, должен возвращать объект, реализующий этот интерфейс, когда вызывается метод getAccessibleValue в AccessibleContext.

Класс AccessibleRole

Этот класс инкапсулирует роль объекта Accessible в пользовательском интерфейсе и получается при вызове метода getAccessibleRole в AccessibleContext. Доступные роли включают «Флажок», «Элемент меню», «Панель» и т. д. Эти роли определяются константами в этом классе, такими как AccessibleRole.CHECK_BOX, AccessibleRole.MENU_ITEM, и AccessibleRole.PANEL. Константы в этом классе представляют собой строго типизированное перечисление общих ролей объектов. Публичный конструктор для этого класса намеренно опущен, и приложения должны использовать одну из констант этого класса. Хотя этот класс предварительно определяет большой список стандартных ролей, он расширяем, поэтому дополнительные роли, определённые программистом, могут быть добавлены в будущем без необходимости изменения базового класса.

Класс AccessibleState

Этот класс инкапсулирует определённое состояние объекта Accessible. Состояния Accessible включают такие вещи, как «Вооружён», «Занят», «Выбран», «Фокусирован» и т. д. Эти роли определяются константами в этом классе, такими как AccessibleState.ARMED, AccessibleState.BUSY, AccessibleState.CHECKED, и AccessibleState.FOCUSED. Сумма всех состояний объекта Accessible называется AccessibleStateSet и может быть получена при вызове метода getAccessibleStateSet в AccessibleContext.

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

Класс AccessibleStateSet

Этот класс инкапсулирует коллекцию состояний объекта Accessible и получается при вызове метода getAccessibleStateSet в AccessibleContext. Поскольку объект может иметь несколько состояний (например, он может быть и «Выбранным», и «Фокусированным»), для инкапсуляции этой коллекции состояний необходим этот класс. Методы в классе обеспечивают получение отдельных AccessibleStates в наборе состояний.

Класс AccessibleBundle

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

Интерфейс AccessibleAction

Интерфейс AccessibleAction должен поддерживаться любым объектом, который может выполнять одно или несколько действий. Этот интерфейс предоставляет стандартный механизм для технологии вспомогательных средств определить эти действия, а также сказать объекту выполнить эти действия. Любой манипулируемый объект должен поддерживать этот интерфейс.

Приложения могут определить, поддерживает ли объект интерфейс AccessibleAction, сначала получив его AccessibleContext (см. Accessible), а затем вызвав метод getAccessibleAction в AccessibleContext. Если возвращаемое значение не равно null, объект поддерживает этот интерфейс.

Интерфейс AccessibleComponent

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

Приложения могут определить, поддерживает ли объект интерфейс AccessibleComponent, сначала получив его AccessibleContext (см. Accessible), а затем вызвав метод getAccessibleComponent в AccessibleContext. Если возвращаемое значение не равно null, объект поддерживает этот интерфейс.

Интерфейс AccessibleSelection

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

Приложения могут определить, поддерживает ли объект интерфейс AccessibleSelection, сначала получив его AccessibleContext (см. Accessible), а затем вызвав метод getAccessibleSelection в AccessibleContext. Если возвращаемое значение не равно null, объект поддерживает этот интерфейс.

Интерфейс AccessibleText

Интерфейс AccessibleText является контрактом для создания доступного богатого и редактируемого текста. Не весь текст, отображаемый на экране, является богатым и редактируемым (например, текст, содержащийся в кнопках, метках, меню и т. д., которые пользователи не должны изменять). Однако объекты, содержащие редактируемый текст, должны реализовывать интерфейс AccessibleText, если они должны взаимодействовать с технологиями вспомогательных средств.

Этот интерфейс предоставляет поддержку перехода между пиксельными координатами и текстом в заданной пиксельной координате, для извлечения буквы, слова и предложения в, до или после заданной позиции в тексте. Этот интерфейс предоставляет поддержку получения атрибутов символа в заданной позиции в тексте (шрифт, размер шрифта, стиль и т. д.), а также получения выделенного текста (при наличии), длины текста и расположения текстового курсора.

Приложения могут определить, поддерживает ли объект интерфейс AccessibleText, сначала получив его AccessibleContext (см. Accessible), а затем вызвав метод getAccessibleText в AccessibleContext. Если возвращаемое значение не равно null, объект поддерживает этот интерфейс.

Интерфейс AccessibleHypertext

Интерфейс должен поддерживаться любым объектом, представляющим гипертекстовую информацию на экране. Этот интерфейс предоставляет стандартный механизм для технологии辅助技术的 доступа к этому тексту через его содержимое, атрибуты и пространственное расположение. Он также предоставляет стандартные механизмы для работы с гиперссылками. Приложения могут определить, поддерживает ли объект интерфейс AccessibleHypertext, сначала получив его AccessibleContext (см. Accessible), а затем вызвав метод AccessibleContext.getAccessibleText() объекта AccessibleContext. Если возвращаемое значение является классом, расширяющим AccessibleHypertext, то этот объект поддерживает AccessibleHypertext.

Интерфейс AccessibleHyperlink

Объект, являющийся гиперссылкой, должен поддерживать интерфейс AccessibleHyperlink. Объект, реализующий этот интерфейс, будет возвращен при вызове метода getLink объекта AccessibleHypertext.

Интерфейс AccessibleValue

Интерфейс AccessibleValue должен поддерживаться любым объектом, который поддерживает числовое значение (например, ползунок). Этот интерфейс предоставляет стандартный механизм для технологии辅助技术的 определения и установки числового значения, а также получения минимального и максимального значений.

Приложения могут определить, поддерживает ли объект интерфейс AccessibleValue, сначала получив его AccessibleContext (см. Accessible), а затем вызвав метод getAccessibleValue объекта AccessibleContext. Если возвращаемое значение не является null, объект поддерживает этот интерфейс.