Пакет 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. Доступные состояния включают такие вещи, как "Вооружен", "Занят", "Отмечен", "Фокусирован" и т. д. Эти роли идентифицируются константами в этом классе, такими как 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, объект поддерживает этот интерфейс.