Пакет 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 ^TM, чтобы позволить технологиям辅助 узнать, когда значения доступных свойств изменяются. 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. Константы в этом классе представляют строго типизированное перечисление распространенных ролей объектов. Целенаправленно опущен конструктор public для этого класса, и приложения должны использовать одну из констант этого класса. Хотя этот класс предопределяет большой список стандартных ролей, он расширяем, так что дополнительные роли, определенные программистом, могут быть добавлены в будущем без необходимости изменения базового класса.

Класс AccessibleState

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

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

Класс 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

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

Интерфейс AccessibleHyperlink

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

Интерфейс AccessibleValue

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

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