Класс AccessibleContext

public abstract class AccessibleContext
extends Object

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

• AccessibleAction - объект может выполнить одно или несколько действий. Этот интерфейс предоставляет стандартный механизм для вспомогательной технологии, чтобы определить, каковы эти действия, и сказать объекту выполнить их. Любой объект, который может быть изменён, должен поддерживать этот интерфейс.
• AccessibleComponent - объект имеет графическое представление. Этот интерфейс предоставляет стандартный механизм для вспомогательной технологии, чтобы определить и установить графическое представление объекта. Любой объект, который отображается на экране, должен поддерживать этот интерфейс.
• AccessibleSelection - объект позволяет выбирать своих дочерние элементы. Этот интерфейс предоставляет стандартный механизм для вспомогательной технологии, чтобы определить текущих выбранных дочерних элементов объекта, а также изменить его набор выбора. Любой объект, у которого есть дочерние элементы, которые могут быть выбраны, должен поддерживать этот интерфейс.
• AccessibleText - объект представляет редактируемую текстовую информацию на экране. Этот интерфейс предоставляет стандартный механизм для вспомогательной технологии, чтобы получить доступ к этому тексту через его содержимое, атрибуты и пространственное расположение. Любой объект, содержащий редактируемый текст, должен поддерживать этот интерфейс.
• AccessibleValue - объект поддерживает числовое значение. Этот интерфейс предоставляет стандартный механизм для вспомогательной технологии, чтобы определить и установить текущее значение объекта, а также получить его минимальное и максимальное значения. Любой объект, который поддерживает числовое значение, должен поддерживать этот интерфейс.

Поля

ACCESSIBLE_NAME_PROPERTY

public static final String ACCESSIBLE_NAME_PROPERTY

Константа, используемая для определения момента изменения свойства accessibleName. Старое значение в PropertyChangeEvent будет старым значением accessibleName, а новое — новым.

См. также:

getAccessibleName(), addPropertyChangeListener(java.beans.PropertyChangeListener), Значения константных полей

ACCESSIBLE_DESCRIPTION_PROPERTY

public static final String ACCESSIBLE_DESCRIPTION_PROPERTY

Константа, используемая для определения момента изменения свойства accessibleDescription. Старое значение в PropertyChangeEvent будет старым значением accessibleDescription, а новое — новым.

См. также:

getAccessibleDescription(), addPropertyChangeListener(java.beans.PropertyChangeListener), Значения константных полей

ACCESSIBLE_STATE_PROPERTY

public static final String ACCESSIBLE_STATE_PROPERTY

Константа, используемая для определения момента изменения свойства accessibleStateSet. Старое значение будет старым состоянием Accessible, а новое — новым в наборе accessibleStateSet. Например, если компонент, поддерживающий вертикальные и горизонтальные состояния, меняет ориентацию с вертикальной на горизонтальную, старое значение будет AccessibleState.VERTICAL, а новое — AccessibleState.HORIZONTAL. Обратите внимание, что любое из этих значений также может быть null. Например, при изменении состояния компонента с enabled на disabled старое значение будет AccessibleState.ENABLED, а новое — null.

См. также:

getAccessibleStateSet(), AccessibleState, AccessibleStateSet, addPropertyChangeListener(java.beans.PropertyChangeListener), Значения константных полей

ACCESSIBLE_VALUE_PROPERTY

public static final String ACCESSIBLE_VALUE_PROPERTY

Константа, используемая для определения момента изменения свойства accessibleValue. Старое значение в PropertyChangeEvent будет числом, представляющим старое значение, а новое значение будет числом, представляющим новое значение.

См. также:

getAccessibleValue(), addPropertyChangeListener(java.beans.PropertyChangeListener), Значения константных полей

ACCESSIBLE_SELECTION_PROPERTY

public static final String ACCESSIBLE_SELECTION_PROPERTY

Константа, используемая для определения момента изменения accessibleSelection. Старые и новые значения в PropertyChangeEvent в настоящее время зарезервированы для будущего использования.

См. также:

getAccessibleSelection(), addPropertyChangeListener(java.beans.PropertyChangeListener), Значения константных полей

ACCESSIBLE_CARET_PROPERTY

public static final String ACCESSIBLE_CARET_PROPERTY

Константа, используемая для определения момента изменения курсора accessibleText. Старое значение в PropertyChangeEvent будет целым числом, представляющим старую позицию курсора, а новое — целым числом, представляющим новую/текущую позицию курсора.

См. также:

addPropertyChangeListener(java.beans.PropertyChangeListener), Значения константных полей

ACCESSIBLE_VISIBLE_DATA_PROPERTY

public static final String ACCESSIBLE_VISIBLE_DATA_PROPERTY

Константа, используемая для определения момента изменения визуального представления объекта. Старые и новые значения в PropertyChangeEvent в настоящее время зарезервированы для будущего использования.

См. также:

addPropertyChangeListener(java.beans.PropertyChangeListener), Значения константных полей

ACCESSIBLE_CHILD_PROPERTY

public static final String ACCESSIBLE_CHILD_PROPERTY

Константа, используемая для определения момента добавления/удаления дочерних элементов Accessible от объекта. Если добавляется дочерний элемент Accessible, старое значение будет null, а новое — дочерний элемент Accessible. Если дочерний элемент Accessible удаляется, старое значение будет дочерним элементом Accessible, а новое — null.

См. также:

addPropertyChangeListener(java.beans.PropertyChangeListener), Значения константных полей

ACCESSIBLE_ACTIVE_DESCENDANT_PROPERTY

public static final String ACCESSIBLE_ACTIVE_DESCENDANT_PROPERTY

Константа, используемая для определения момента изменения активного дочернего элемента компонента. Активный дочерний элемент используется для объектов, таких как списки, деревья и таблицы, которые могут иметь временные дочерние элементы. При изменении активного дочернего элемента старое значение события изменения свойства будет Accessible, представляющим предыдущий активный дочерний элемент, а новое значение будет Accessible, представляющим текущий активный дочерний элемент.

См. также:

addPropertyChangeListener(java.beans.PropertyChangeListener), Значения константных полей

ACCESSIBLE_TABLE_CAPTION_CHANGED

public static final String ACCESSIBLE_TABLE_CAPTION_CHANGED

Константа, используемая для указания изменения заголовка таблицы. Старое значение в PropertyChangeEvent будет Accessible, представляющим предыдущий заголовок таблицы, а новое — Accessible, представляющим новый заголовок таблицы.

См. также:

Accessible, AccessibleTable, Значения константных полей

ACCESSIBLE_TABLE_SUMMARY_CHANGED

public static final String ACCESSIBLE_TABLE_SUMMARY_CHANGED

Константа, используемая для указания изменения сводки таблицы. Старое значение в PropertyChangeEvent будет Accessible, представляющим предыдущую сводку таблицы, а новое — Accessible, представляющим новую сводку таблицы.

См. также:

Accessible, AccessibleTable, Значения константных полей

ACCESSIBLE_TABLE_MODEL_CHANGED

public static final String ACCESSIBLE_TABLE_MODEL_CHANGED

Константа, используемая для указания изменения данных таблицы. Старое значение в PropertyChangeEvent будет null, а новое — AccessibleTableModelChange, представляющим изменение таблицы.

См. также:

AccessibleTable, AccessibleTableModelChange, Значения константных полей

ACCESSIBLE_TABLE_ROW_HEADER_CHANGED

public static final String ACCESSIBLE_TABLE_ROW_HEADER_CHANGED

Константа, используемая для указания изменения заголовка строки. Старое значение в PropertyChangeEvent будет null, а новое — AccessibleTableModelChange, представляющим изменение заголовка.

См. также:

AccessibleTable, AccessibleTableModelChange, Значения константных полей

ACCESSIBLE_TABLE_ROW_DESCRIPTION_CHANGED

public static final String ACCESSIBLE_TABLE_ROW_DESCRIPTION_CHANGED

Константа, используемая для указания изменения описания строки. Старое значение в PropertyChangeEvent будет null, а новое — целое число, представляющее индекс строки.

См. также:

AccessibleTable, Значения константных полей

ACCESSIBLE_TABLE_COLUMN_HEADER_CHANGED

public static final String ACCESSIBLE_TABLE_COLUMN_HEADER_CHANGED

Константа, используемая для указания изменения заголовка столбца. Старое значение в PropertyChangeEvent будет null, а новое — AccessibleTableModelChange, представляющим изменение заголовка.

См. также:

AccessibleTable, AccessibleTableModelChange, Значения константных полей

ACCESSIBLE_TABLE_COLUMN_DESCRIPTION_CHANGED

public static final String ACCESSIBLE_TABLE_COLUMN_DESCRIPTION_CHANGED

Константа, используемая для указания изменения описания столбца. Старое значение в PropertyChangeEvent будет null, а новое — целое число, представляющее индекс столбца.

См. также:

AccessibleTable, Значения константных полей

ACCESSIBLE_ACTION_PROPERTY

public static final String ACCESSIBLE_ACTION_PROPERTY

Константа, используемая для указания изменения набора поддерживаемых действий. Старое значение в PropertyChangeEvent будет целым числом, представляющим старое количество поддерживаемых действий, а новое значение — целым числом, представляющим новое количество поддерживаемых действий.

См. также:

AccessibleAction, Значения константных полей

ACCESSIBLE_HYPERTEXT_OFFSET

public static final String ACCESSIBLE_HYPERTEXT_OFFSET

Константа, используемая для указания того, что гипертекстовый элемент получил фокус. Старое значение в PropertyChangeEvent будет целым числом, представляющим начальный индекс в документе предыдущего элемента, который имел фокус, а новое значение будет целым числом, представляющим начальный индекс в документе текущего элемента, который имеет фокус. Значение -1 указывает, что элемент не имеет или не имел фокуса.

См. также:

AccessibleHyperlink, Значения константных полей

ACCESSIBLE_TEXT_PROPERTY

public static final String ACCESSIBLE_TEXT_PROPERTY

PropertyChangeEvent, указывающий на изменение текста.
При вставке текста oldValue равно null, а newValue — AccessibleTextSequence, определяющая вставленный текст.
При удалении текста oldValue — AccessibleTextSequence, определяющая удалённый текст, а newValue равно null.
При замене текста oldValue — AccessibleTextSequence, определяющая старый текст, а newValue — AccessibleTextSequence, определяющая новый текст.

См. также:

getAccessibleText(), addPropertyChangeListener(java.beans.PropertyChangeListener), AccessibleTextSequence, Значения константных полей

ACCESSIBLE_INVALIDATE_CHILDREN

public static final String ACCESSIBLE_INVALIDATE_CHILDREN

PropertyChangeEvent, указывающий на значительное изменение потомков компонента, например, дерева или текста. Это изменение уведомляет слушатель события о необходимости повторного получения состояния подкомпонентов. oldValue равно null, а newValue — компонент, потомки которого стали недопустимыми.

С:

1.5

См. также:

getAccessibleText(), addPropertyChangeListener(java.beans.PropertyChangeListener), AccessibleTextSequence, Значения константных полей

ACCESSIBLE_TEXT_ATTRIBUTES_CHANGED

public static final String ACCESSIBLE_TEXT_ATTRIBUTES_CHANGED

PropertyChangeEvent, указывающий на изменение атрибутов текста.
При вставке атрибутов oldValue равно null, а newValue — AccessibleAttributeSequence, определяющая вставленные атрибуты.
При удалении атрибутов oldValue — AccessibleAttributeSequence, определяющая удалённые атрибуты, а newValue равно null.
При замене атрибутов oldValue — AccessibleAttributeSequence, определяющая старые атрибуты, а newValue — AccessibleAttributeSequence, определяющая новые атрибуты.

С:

1.5

См. также:

getAccessibleText(), addPropertyChangeListener(java.beans.PropertyChangeListener), AccessibleAttributeSequence, Значения константных полей

ACCESSIBLE_COMPONENT_BOUNDS_CHANGED

public static final String ACCESSIBLE_COMPONENT_BOUNDS_CHANGED

PropertyChangeEvent, указывающий на изменение границ компонента. oldValue — старые границы компонента, а newValue — новые границы компонента.

С:

1.5

См. также:

addPropertyChangeListener(java.beans.PropertyChangeListener), Значения константных полей

accessibleParent

protected Accessible accessibleParent

Родительский элемент доступности для данного объекта.

См. также:

getAccessibleParent(), setAccessibleParent(javax.accessibility.Accessible)

accessibleName

protected String accessibleName

Локализованная строка, содержащая имя объекта.

См. также:

getAccessibleName(), setAccessibleName(java.lang.String)

accessibleDescription

protected String accessibleDescription

Локализованная строка, содержащая описание объекта.

См. также:

getAccessibleDescription(), setAccessibleDescription(java.lang.String)

Конструкторы

AccessibleContext

public AccessibleContext()

Методы

getAccessibleName

public String getAccessibleName()

Получает свойство accessibleName этого объекта. Свойство accessibleName объекта — локализованная строка, обозначающая назначение объекта. Например, свойство accessibleName метки или кнопки может быть самим текстом метки или кнопки. В случае объекта, который не отображает своё имя, accessibleName всё равно должен быть установлен. Например, в случае текстового поля, используемого для ввода имени города, accessibleName для локали en_US может быть 'city'.

Возвращает:

локализованное имя объекта; null, если у этого объекта нет имени

См. также:

setAccessibleName(java.lang.String)

setAccessibleName

public void setAccessibleName(String s)

Устанавливает локализованное имя доступности этого объекта. Изменение имени вызовет срабатывание PropertyChangeEvent для свойства ACCESSIBLE_NAME_PROPERTY.

Параметры:

s - новое локализованное имя объекта.

См. также:

getAccessibleName(), addPropertyChangeListener(java.beans.PropertyChangeListener)

getAccessibleDescription

public String getAccessibleDescription()

Получает свойство accessibleDescription этого объекта. Свойство accessibleDescription этого объекта — короткая локализованная фраза, описывающая назначение объекта. Например, в случае кнопки «Отмена» accessibleDescription может быть «Игнорировать изменения и закрыть диалоговое окно».

Возвращает:

локализованное описание объекта; null, если у этого объекта нет описания

См. также:

setAccessibleDescription(java.lang.String)

setAccessibleDescription

public void setAccessibleDescription(String s)

Устанавливает описание доступности этого объекта. Изменение имени вызовет срабатывание PropertyChangeEvent для свойства ACCESSIBLE_DESCRIPTION_PROPERTY.

Параметры:

s - новое локализованное описание объекта

См. также:

setAccessibleName(java.lang.String), addPropertyChangeListener(java.beans.PropertyChangeListener)

getAccessibleRole

public abstract AccessibleRole getAccessibleRole()

Возвращает:

экземпляр AccessibleRole, описывающий роль объекта

См. также:

AccessibleRole

getAccessibleStateSet

public abstract AccessibleStateSet getAccessibleStateSet()

Получает набор состояний этого объекта. AccessibleStateSet объекта состоит из набора уникальных AccessibleStates. Изменение AccessibleStateSet объекта вызовет срабатывание PropertyChangeEvent для свойства ACCESSIBLE_STATE_PROPERTY.

Возвращает:

экземпляр AccessibleStateSet, содержащий текущий набор состояний объекта

См. также:

AccessibleStateSet, AccessibleState, addPropertyChangeListener(java.beans.PropertyChangeListener)

getAccessibleParent

public Accessible getAccessibleParent()

Получает родителя доступности этого объекта.

Возвращает:

родителя доступности этого объекта; null, если у этого объекта нет родителя доступности

setAccessibleParent

public void setAccessibleParent(Accessible a)

Устанавливает родителя доступности этого объекта. Это предназначено только для случаев, когда фактический родитель компонента не должен рассматриваться как родитель доступности компонента, и это метод, который должен вызываться только родителем доступного дочернего элемента.

Параметры:

a - - элемент доступности, который нужно установить в качестве родителя

getAccessibleIndexInParent

public abstract int getAccessibleIndexInParent()

Получает индекс этого объекта в родительском элементе доступности (с нуля).

Возвращает:

базовой индекс этого объекта в его родительском элементе; -1, если у этого объекта нет доступного родителя.

См. также:

getAccessibleParent(), getAccessibleChildrenCount(), getAccessibleChild(int)

getAccessibleChildrenCount

public abstract int getAccessibleChildrenCount()

Возвращает количество доступных дочерних элементов объекта.

Возвращает:

количество доступных дочерних элементов объекта.

getAccessibleChild

public abstract Accessible getAccessibleChild(int i)

Возвращает указанного доступного дочернего элемента объекта. Доступные дочерние элементы доступного объекта нумеруются с нуля, поэтому первый дочерний элемент доступного элемента имеет индекс 0, второй дочерний элемент — индекс 1 и так далее.

Параметры:

i - индекс дочернего элемента (с нуля)

Возвращает:

доступный дочерний элемент объекта

См. также:

getAccessibleChildrenCount()

getLocale

public abstract Locale getLocale()
                          throws IllegalComponentStateException

Получает локаль компонента. Если компонент не имеет локали, возвращается локаль его родителя.

Возвращает:

локаль этого компонента. Если у этого компонента нет локали, возвращается локаль его родителя.

Исключения:

IllegalComponentStateException - Если компонент не имеет собственной локали и еще не добавлен в иерархию контейнеров, так что локаль не может быть определена из родительского контейнера.

addPropertyChangeListener

public void addPropertyChangeListener(PropertyChangeListener listener)

Добавляет обработчик PropertyChangeListener в список обработчиков. Обработчик регистрируется для всех доступных свойств и будет вызываться при изменении этих свойств.

Параметры:

listener - Добавляемый обработчик PropertyChangeListener

См. также:

ACCESSIBLE_NAME_PROPERTY, ACCESSIBLE_DESCRIPTION_PROPERTY, ACCESSIBLE_STATE_PROPERTY, ACCESSIBLE_VALUE_PROPERTY, ACCESSIBLE_SELECTION_PROPERTY, ACCESSIBLE_TEXT_PROPERTY, ACCESSIBLE_VISIBLE_DATA_PROPERTY

removePropertyChangeListener

public void removePropertyChangeListener(PropertyChangeListener listener)

Удаляет обработчик PropertyChangeListener из списка обработчиков. Это удаляет обработчик PropertyChangeListener, который был зарегистрирован для всех свойств.

Параметры:

listener - Удаляемый обработчик PropertyChangeListener

getAccessibleAction

public AccessibleAction getAccessibleAction()

Получает AccessibleAction, связанный с этим объектом, который поддерживает одно или несколько действий.

Возвращает:

AccessibleAction, если поддерживается объектом; в противном случае возвращает null

См. также:

AccessibleAction

getAccessibleComponent

public AccessibleComponent getAccessibleComponent()

Получает AccessibleComponent, связанный с этим объектом, имеющим графическое представление.

Возвращает:

AccessibleComponent, если поддерживается объектом; в противном случае возвращает null

См. также:

AccessibleComponent

getAccessibleSelection

public AccessibleSelection getAccessibleSelection()

Получает AccessibleSelection, связанный с этим объектом, который позволяет выбирать его дочерние элементы.

Возвращает:

AccessibleSelection, если поддерживается объектом; в противном случае возвращает null

См. также:

AccessibleSelection

getAccessibleText

public AccessibleText getAccessibleText()

Получает AccessibleText, связанный с этим объектом, представляющим текст на дисплее.

Возвращает:

AccessibleText, если поддерживается объектом; в противном случае возвращает null

См. также:

AccessibleText

getAccessibleEditableText

public AccessibleEditableText getAccessibleEditableText()

Получает AccessibleEditableText, связанный с этим объектом, представляющим редактируемый текст на дисплее.

Возвращает:

AccessibleEditableText, если поддерживается объектом; в противном случае возвращает null

С:

1.4

См. также:

AccessibleEditableText

getAccessibleValue

public AccessibleValue getAccessibleValue()

Получает AccessibleValue, связанный с этим объектом, который поддерживает числовое значение.

Возвращает:

AccessibleValue, если поддерживается объектом; в противном случае возвращает null

См. также:

AccessibleValue

getAccessibleIcon

public AccessibleIcon[] getAccessibleIcon()

Получает AccessibleIcons, связанные с объектом, у которого есть один или несколько связанных значков.

Возвращает:

массив AccessibleIcon, если поддерживается объектом; в противном случае возвращает null

С:

1.3

См. также:

AccessibleIcon

getAccessibleRelationSet

public AccessibleRelationSet getAccessibleRelationSet()

Получает AccessibleRelationSet, связанный с объектом.

Возвращает:

AccessibleRelationSet, если поддерживается объектом; в противном случае возвращает null

С:

1.3

См. также:

AccessibleRelationSet

getAccessibleTable

public AccessibleTable getAccessibleTable()

Получает AccessibleTable, связанный с объектом.

Возвращает:

AccessibleTable, если поддерживается объектом; в противном случае возвращает null

С:

1.3

См. также:

AccessibleTable

firePropertyChange

public void firePropertyChange(String propertyName,
                               Object oldValue,
                               Object newValue)

Поддержка для уведомления об изменениях связанных свойств. Если oldValue и newValue не равны, и список слушателей PropertyChangeEvent не пуст, генерируется событие PropertyChange для каждого слушателя. Как правило, это используется самими объектами Accessible и не должно вызываться программой приложения.

Параметры:

propertyName - Программное имя свойства, которое было изменено.

oldValue - Старое значение свойства.

newValue - Новое значение свойства.

См. также:

PropertyChangeSupport, addPropertyChangeListener(java.beans.PropertyChangeListener), removePropertyChangeListener(java.beans.PropertyChangeListener), ACCESSIBLE_NAME_PROPERTY, ACCESSIBLE_DESCRIPTION_PROPERTY, ACCESSIBLE_STATE_PROPERTY, ACCESSIBLE_VALUE_PROPERTY, ACCESSIBLE_SELECTION_PROPERTY, ACCESSIBLE_TEXT_PROPERTY, ACCESSIBLE_VISIBLE_DATA_PROPERTY