Пакет 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. Поскольку объект может иметь несколько состояний (например, он может быть одновременно "Выбран" и "Фокус"), для инкапсуляции такой коллекции состояний необходим этот класс. Методы класса обеспечивают получение отдельных AccessibleState в наборе состояний.

Класс 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, объект поддерживает этот интерфейс.