Пакет javax.accessibility

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

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

Интерфейс Accessible

Интерфейс Accessible — это основной интерфейс Java Accessibility API. Все компоненты, поддерживающие Java Accessibility API, должны реализовывать этот интерфейс. Он содержит единственный метод 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. Поскольку объект может иметь несколько состояний (например, он может быть одновременно «Выбранным» и «В фокусе»), для инкапсуляции набора этих состояний необходим этот класс. Методы класса обеспечивают получение отдельных 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, то объект поддерживает этот интерфейс.