Пакет javax.accessibility

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

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

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