Класс JComponent.AccessibleJComponent

javax.swing.JComponent.AccessibleJComponent

Все реализованные интерфейсы:: Serializable, AccessibleComponent, AccessibleExtendedComponent

Прямые известные подклассы:: AbstractButton.AccessibleAbstractButton, JColorChooser.AccessibleJColorChooser, JComboBox.AccessibleJComboBox, JDesktopPane.AccessibleJDesktopPane, JFileChooser.AccessibleJFileChooser, JInternalFrame.AccessibleJInternalFrame, JInternalFrame.JDesktopIcon.AccessibleJDesktopIcon, JLabel.AccessibleJLabel, JLayeredPane.AccessibleJLayeredPane, JList.AccessibleJList, JMenuBar.AccessibleJMenuBar, JOptionPane.AccessibleJOptionPane, JPanel.AccessibleJPanel, JPopupMenu.AccessibleJPopupMenu, JProgressBar.AccessibleJProgressBar, JRootPane.AccessibleJRootPane, JScrollBar.AccessibleJScrollBar, JScrollPane.AccessibleJScrollPane, JSeparator.AccessibleJSeparator, JSlider.AccessibleJSlider, JSpinner.AccessibleJSpinner, JSplitPane.AccessibleJSplitPane, JTabbedPane.AccessibleJTabbedPane, JTable.AccessibleJTable, JTableHeader.AccessibleJTableHeader, JTextComponent.AccessibleJTextComponent, JToolBar.AccessibleJToolBar, JToolTip.AccessibleJToolTip, JTree.AccessibleJTree, JViewport.AccessibleJViewport

Внешний класс:: JComponent

public abstract class JComponent.AccessibleJComponent extends Container.AccessibleAWTContainer implements AccessibleExtendedComponent

Внутренний класс JComponent, используемый для обеспечения поддержки специальных возможностей по умолчанию. Этот класс не предназначен для непосредственного использования разработчиками приложений, а предназначен только для наследования разработчиками компонентов.

Предупреждение: Сериализованные объекты этого класса не будут совместимы с будущими выпусками Swing. Текущая поддержка сериализации подходит для кратковременного хранения или RMI между приложениями, работающими с одной и той же версией Swing. Начиная с версии 1.4, поддержка долгосрочного хранения всех JavaBeans была добавлена в пакет java.beans. См. XMLEncoder.

Начиная с:: 1.2

Краткое описание вложенных классов

Модификатор и тип	Класс	Описание
`protected class`	`JComponent.AccessibleJComponent.AccessibleContainerHandler`	Вызывает слушатель PropertyChange, если он зарегистрирован, при добавлении или удалении дочерних элементов.
`protected class`	`JComponent.AccessibleJComponent.AccessibleFocusHandler`	Устарело. Этот класс больше не используется и не требуется.

Вложенные классы/интерфейсы, объявленные в классе Component.AccessibleAWTComponent

Component.AccessibleAWTComponent.AccessibleAWTComponentHandler, Component.AccessibleAWTComponent.AccessibleAWTFocusHandler

Модификатор и тип	Класс	Описание
`protected class`	`Component.AccessibleAWTComponent.AccessibleAWTComponentHandler`	Вызывает слушатель PropertyChange, если он зарегистрирован, при отображении или скрытии..
`protected class`	`Component.AccessibleAWTComponent.AccessibleAWTFocusHandler`	Вызывает слушатель PropertyChange, если он зарегистрирован, при возникновении событий фокуса

Краткое описание полей

Модификатор и тип	Поле	Описание
`protected FocusListener`	`accessibleFocusHandler`	Устарело.

Поля, объявленные в классе Container.AccessibleAWTContainer

accessibleContainerHandler

Модификатор и тип	Поле	Описание
`protected ContainerListener`	`accessibleContainerHandler`	Обработчик для вызова `PropertyChange` при добавлении или удалении дочерних элементов

Поля, объявленные в классе Component.AccessibleAWTComponent

accessibleAWTComponentHandler, accessibleAWTFocusHandler

Модификатор и тип	Поле	Описание
`protected ComponentListener`	`accessibleAWTComponentHandler`	Слушатель компонента для отслеживания событий отображения/скрытия/изменения размера и преобразования их в события PropertyChange.
`protected FocusListener`	`accessibleAWTFocusHandler`	Слушатель для отслеживания событий фокуса и преобразования их в события PropertyChange.

Поля, объявленные в классе AccessibleContext

ACCESSIBLE_ACTION_PROPERTY, ACCESSIBLE_ACTIVE_DESCENDANT_PROPERTY, ACCESSIBLE_CARET_PROPERTY, ACCESSIBLE_CHILD_PROPERTY, ACCESSIBLE_COMPONENT_BOUNDS_CHANGED, ACCESSIBLE_DESCRIPTION_PROPERTY, ACCESSIBLE_HYPERTEXT_OFFSET, ACCESSIBLE_INVALIDATE_CHILDREN, ACCESSIBLE_NAME_PROPERTY, ACCESSIBLE_SELECTION_PROPERTY, ACCESSIBLE_STATE_PROPERTY, ACCESSIBLE_TABLE_CAPTION_CHANGED, ACCESSIBLE_TABLE_COLUMN_DESCRIPTION_CHANGED, ACCESSIBLE_TABLE_COLUMN_HEADER_CHANGED, ACCESSIBLE_TABLE_MODEL_CHANGED, ACCESSIBLE_TABLE_ROW_DESCRIPTION_CHANGED, ACCESSIBLE_TABLE_ROW_HEADER_CHANGED, ACCESSIBLE_TABLE_SUMMARY_CHANGED, ACCESSIBLE_TEXT_ATTRIBUTES_CHANGED, ACCESSIBLE_TEXT_PROPERTY, ACCESSIBLE_VALUE_PROPERTY, ACCESSIBLE_VISIBLE_DATA_PROPERTY, accessibleDescription, accessibleName, accessibleParent

Модификатор и тип	Поле	Описание
`static final String`	`ACCESSIBLE_ACTION_PROPERTY`	Константа, используемая для указания на изменение поддерживаемого набора действий.
`static final String`	`ACCESSIBLE_ACTIVE_DESCENDANT_PROPERTY`	Константа, используемая для определения изменения активного потомка компонента.
`static final String`	`ACCESSIBLE_CARET_PROPERTY`	Константа, используемая для определения изменения каретки `accessibleText`.
`static final String`	`ACCESSIBLE_CHILD_PROPERTY`	Константа, используемая для определения добавления/удаления дочерних элементов `Accessible` из объекта.
`static final String`	`ACCESSIBLE_COMPONENT_BOUNDS_CHANGED`	`PropertyChangeEvent`, указывающая на изменение границ компонента.
`static final String`	`ACCESSIBLE_DESCRIPTION_PROPERTY`	Константа, используемая для определения изменения свойства `AccessibleContext.accessibleDescription`.
`static final String`	`ACCESSIBLE_HYPERTEXT_OFFSET`	Константа, используемая для указания на то, что гипертекстовый элемент получил фокус.
`static final String`	`ACCESSIBLE_INVALIDATE_CHILDREN`	`PropertyChangeEvent`, указывающая на существенное изменение дочерних элементов компонента, например дерева или текста.
`static final String`	`ACCESSIBLE_NAME_PROPERTY`	Константа, используемая для определения изменения свойства `AccessibleContext.accessibleName`.
`static final String`	`ACCESSIBLE_SELECTION_PROPERTY`	Константа, используемая для определения изменения `accessibleSelection`.
`static final String`	`ACCESSIBLE_STATE_PROPERTY`	Константа, используемая для определения изменения свойства `accessibleStateSet`.
`static final String`	`ACCESSIBLE_TABLE_CAPTION_CHANGED`	Константа, используемая для указания на изменение заголовка таблицы.
`static final String`	`ACCESSIBLE_TABLE_COLUMN_DESCRIPTION_CHANGED`	Константа, используемая для указания на изменение описания столбца.
`static final String`	`ACCESSIBLE_TABLE_COLUMN_HEADER_CHANGED`	Константа, используемая для указания на изменение заголовка столбца.
`static final String`	`ACCESSIBLE_TABLE_MODEL_CHANGED`	Константа, используемая для указания на изменение данных таблицы.
`static final String`	`ACCESSIBLE_TABLE_ROW_DESCRIPTION_CHANGED`	Константа, используемая для указания на изменение описания строки.
`static final String`	`ACCESSIBLE_TABLE_ROW_HEADER_CHANGED`	Константа, используемая для указания на изменение заголовка строки.
`static final String`	`ACCESSIBLE_TABLE_SUMMARY_CHANGED`	Константа, используемая для указания на изменение сводки таблицы.
`static final String`	`ACCESSIBLE_TEXT_ATTRIBUTES_CHANGED`	`PropertyChangeEvent`, указывающая на изменение текстовых атрибутов.
`static final String`	`ACCESSIBLE_TEXT_PROPERTY`	`PropertyChangeEvent`, указывающая на изменение текста.
`static final String`	`ACCESSIBLE_VALUE_PROPERTY`	Константа, используемая для определения изменения свойства `accessibleValue`.
`static final String`	`ACCESSIBLE_VISIBLE_DATA_PROPERTY`	Константа, используемая для определения изменения внешнего вида объекта.
`protected String`	`accessibleDescription`	Локализованная строка, содержащая описание объекта.
`protected String`	`accessibleName`	Локализованная строка, содержащая имя объекта.
`protected Accessible`	`accessibleParent`	Родитель этого объекта, доступный для специальных возможностей.

Краткое описание конструкторов

AccessibleJComponent()

Модификатор	Конструктор	Описание
`protected`	Хотя класс является абстрактным, этот конструктор должны вызывать все подклассы.

Краткое описание методов

Модификатор и тип	Метод	Описание
`void`	`addPropertyChangeListener(PropertyChangeListener listener)`	Добавляет PropertyChangeListener в список слушателей.
`Accessible`	`getAccessibleChild(int i)`	Возвращает n-й дочерний объект с поддержкой специальных возможностей.
`int`	`getAccessibleChildrenCount()`	Возвращает количество дочерних объектов с поддержкой специальных возможностей.
`String`	`getAccessibleDescription()`	Возвращает описание этого объекта для специальных возможностей.
`AccessibleKeyBinding`	`getAccessibleKeyBinding()`	Возвращает привязки клавиш, связанные с этим объектом
`String`	`getAccessibleName()`	Возвращает имя этого объекта для специальных возможностей.
`AccessibleRole`	`getAccessibleRole()`	Возвращает роль этого объекта.
`AccessibleStateSet`	`getAccessibleStateSet()`	Возвращает состояние этого объекта.
`protected String`	`getBorderTitle(Border b)`	Рекурсивно выполняет поиск в иерархии границ (если она существует) объекта TitledBorder с ненулевым заголовком.
`String`	`getTitledBorderText()`	Возвращает текст рамки с заголовком
`String`	`getToolTipText()`	Возвращает текст подсказки
`void`	`removePropertyChangeListener(PropertyChangeListener listener)`	Удаляет PropertyChangeListener из списка слушателей.

Методы, объявленные в классе Container.AccessibleAWTContainer

getAccessibleAt

Модификатор и тип	Метод	Описание
`Accessible`	`getAccessibleAt(Point p)`	Возвращает дочерний объект `Accessible`, если он существует, содержащийся в локальной координате `Point`.

Методы, объявленные в классе Component.AccessibleAWTComponent

addFocusListener, contains, getAccessibleComponent, getAccessibleIndexInParent, getAccessibleParent, getBackground, getBounds, getCursor, getFont, getFontMetrics, getForeground, getLocale, getLocation, getLocationOnScreen, getSize, isEnabled, isFocusTraversable, isShowing, isVisible, removeFocusListener, requestFocus, setBackground, setBounds, setCursor, setEnabled, setFont, setForeground, setLocation, setSize, setVisible

Модификатор и тип	Метод	Описание
`void`	`addFocusListener(FocusListener l)`	Добавляет указанный слушатель фокуса, чтобы получать события фокуса от этого компонента.
`boolean`	`contains(Point p)`	Проверяет, находится ли указанная точка в пределах границ этого объекта; координаты x и y точки заданы относительно системы координат объекта.
`AccessibleComponent`	`getAccessibleComponent()`	Возвращает связанный с этим объектом `AccessibleComponent`, если он существует.
`int`	`getAccessibleIndexInParent()`	Возвращает индекс этого объекта в его родительском объекте, доступном для специальных возможностей.
`Accessible`	`getAccessibleParent()`	Возвращает `Accessible` родительский объект этого объекта.
`Color`	`getBackground()`	Возвращает цвет фона этого объекта.
`Rectangle`	`getBounds()`	Возвращает границы этого объекта в виде объекта Rectangle.
`Cursor`	`getCursor()`	Возвращает `Cursor` этого объекта.
`Font`	`getFont()`	Возвращает `Font` этого объекта.
`FontMetrics`	`getFontMetrics(Font f)`	Возвращает `FontMetrics` этого объекта.
`Color`	`getForeground()`	Возвращает цвет переднего плана этого объекта.
`Locale`	`getLocale()`	Возвращает локаль этого объекта.
`Point`	`getLocation()`	Возвращает местоположение объекта относительно родительского объекта в виде точки, задающей верхний левый угол объекта в системе координат экрана.
`Point`	`getLocationOnScreen()`	Возвращает местоположение объекта на экране.
`Dimension`	`getSize()`	Возвращает размер этого объекта в виде объекта `Dimension`.
`boolean`	`isEnabled()`	Определяет, включен ли объект.
`boolean`	`isFocusTraversable()`	Возвращает, может ли этот объект получать фокус.
`boolean`	`isShowing()`	Определяет, отображается ли объект.
`boolean`	`isVisible()`	Определяет, видим ли объект.
`void`	`removeFocusListener(FocusListener l)`	Удаляет указанный слушатель фокуса, чтобы он больше не получал события фокуса от этого компонента.
`void`	`requestFocus()`	Запрашивает фокус для этого объекта.
`void`	`setBackground(Color c)`	Задает цвет фона этого объекта.
`void`	`setBounds(Rectangle r)`	Задает границы этого объекта в виде объекта `Rectangle`.
`void`	`setCursor(Cursor cursor)`	Задает `Cursor` этого объекта.
`void`	`setEnabled(boolean b)`	Задает состояние включения объекта.
`void`	`setFont(Font f)`	Задает `Font` этого объекта.
`void`	`setForeground(Color c)`	Задает цвет переднего плана этого объекта.
`void`	`setLocation(Point p)`	Задает местоположение объекта относительно родительского объекта.
`void`	`setSize(Dimension d)`	Изменяет размер этого объекта, задавая его ширину и высоту.
`void`	`setVisible(boolean b)`	Задает видимое состояние объекта.

Методы, объявленные в классе AccessibleContext

firePropertyChange, getAccessibleAction, getAccessibleEditableText, getAccessibleIcon, getAccessibleRelationSet, getAccessibleSelection, getAccessibleTable, getAccessibleText, getAccessibleValue, setAccessibleDescription, setAccessibleName, setAccessibleParent

Модификатор и тип	Метод	Описание
`void`	`firePropertyChange(String propertyName, Object oldValue, Object newValue)`	Поддержка уведомления об изменениях связанных свойств.
`AccessibleAction`	`getAccessibleAction()`	Возвращает связанный с этим объектом `AccessibleAction`, поддерживающий одно или несколько действий.
`AccessibleEditableText`	`getAccessibleEditableText()`	Возвращает связанный с этим объектом `AccessibleEditableText`, отображающий на экране редактируемый текст.
`AccessibleIcon[]`	`getAccessibleIcon()`	Возвращает связанный с объектом `AccessibleIcons`, имеющим один или несколько связанных значков.
`AccessibleRelationSet`	`getAccessibleRelationSet()`	Возвращает связанный с объектом `AccessibleRelationSet`.
`AccessibleSelection`	`getAccessibleSelection()`	Возвращает связанный с этим объектом `AccessibleSelection`, позволяющий выбирать его дочерние элементы `Accessible`.
`AccessibleTable`	`getAccessibleTable()`	Возвращает связанный с объектом `AccessibleTable`.
`AccessibleText`	`getAccessibleText()`	Возвращает связанный с этим объектом `AccessibleText`, отображающий текст на экране.
`AccessibleValue`	`getAccessibleValue()`	Возвращает связанный с этим объектом `AccessibleValue`, поддерживающий значение `Numerical`.
`void`	`setAccessibleDescription(String s)`	Задает описание этого объекта для специальных возможностей.
`void`	`setAccessibleName(String s)`	Задает локализованное имя этого объекта для специальных возможностей.
`void`	`setAccessibleParent(Accessible a)`	Задает `Accessible` родительский объект этого объекта.

Методы, объявленные в классе Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создает и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Указывает, равен ли другой объект этому объекту.
`protected void`	`finalize()`	Устарело и подлежит удалению: этот элемент API может быть удален в будущей версии. Финализация устарела и может быть удалена в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`String`	`toString()`	Возвращает строковое представление объекта.
`final void`	`wait()`	Переводит текущий поток в состояние ожидания до пробуждения, обычно в результате уведомления или прерывания.
`final void`	`wait(long timeoutMillis)`	Переводит текущий поток в состояние ожидания до пробуждения, обычно в результате уведомления или прерывания, либо до истечения заданного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Переводит текущий поток в состояние ожидания до пробуждения, обычно в результате уведомления или прерывания, либо до истечения заданного промежутка реального времени.

Подробное описание полей

accessibleFocusHandler

@Deprecated protected FocusListener accessibleFocusHandler

Устарело.

Это поле дублирует функцию поля accessibleAWTFocusHandler в java.awt.Component.AccessibleAWTComponent, поэтому оно устарело.

Подробное описание конструкторов

AccessibleJComponent

protected AccessibleJComponent()

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

Подробное описание методов

addPropertyChangeListener

public void addPropertyChangeListener(PropertyChangeListener listener)

Добавляет PropertyChangeListener в список слушателей.

Переопределяет:

addPropertyChangeListener в классе Container.AccessibleAWTContainer

Параметры:

listener — добавляемый PropertyChangeListener

См. также:

removePropertyChangeListener

public void removePropertyChangeListener(PropertyChangeListener listener)

Удаляет PropertyChangeListener из списка слушателей. При этом удаляется PropertyChangeListener, зарегистрированный для всех свойств.

Переопределяет:: removePropertyChangeListener в классе Container.AccessibleAWTContainer
Параметры:: listener — удаляемый PropertyChangeListener

getBorderTitle

protected String getBorderTitle(Border b)

Рекурсивно ищет в иерархии границ (если она существует) TitledBorder с ненулевым заголовком. Поиск выполняется в глубину: сначала во внутренних, затем во внешних границах. Предполагается, что заголовки хорошо смотрятся на внутренних границах, но не очень хорошо — на внешних в составных границах. Это решение довольно произвольное, но, будем надеяться, хорошие разработчики пользовательского интерфейса не будут создавать несколько границ с заголовками для одного компонента.

Параметры:: b — Border, заголовок которого требуется получить
Возвращает:: заголовок границы в виде String; null, если заголовка нет

getAccessibleName

public String getAccessibleName()

Возвращает доступное имя этого объекта. Почти никогда не следует возвращать java.awt.Component.getName(), поскольку обычно это имя не локализовано и не имеет смысла для пользователя. Если объект по своей сути является текстовым объектом (например, пунктом меню), доступным именем должен быть текст объекта (например, «сохранить»). Если у объекта есть всплывающая подсказка, подходящей строкой для возврата также может быть текст подсказки.

Переопределяет:

getAccessibleName в классе Component.AccessibleAWTComponent

Возвращает:

локализованное имя объекта; может быть null, если у объекта нет имени

См. также:

getAccessibleDescription

public String getAccessibleDescription()

Возвращает доступное описание этого объекта. Это должно быть краткое локализованное описание того, что представляет собой объект, — его значения для пользователя. Если у объекта есть всплывающая подсказка, подходящей строкой для возврата может быть текст подсказки, если он содержит краткое описание объекта (а не только его название: например, для значка «Сохранить» на панели инструментов с текстом подсказки «сохранить» не следует возвращать текст подсказки в качестве описания; вместо этого подойдет что-то вроде «Сохраняет текущий текстовый документ»).

Переопределяет:

getAccessibleDescription в классе Component.AccessibleAWTComponent

Возвращает:

локализованное описание объекта; может быть null, если у объекта нет описания

См. также:

getAccessibleRole

public AccessibleRole getAccessibleRole()

Возвращает роль этого объекта.

Переопределяет:

getAccessibleRole в классе Component.AccessibleAWTComponent

Возвращает:

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

См. также:

getAccessibleStateSet

public AccessibleStateSet getAccessibleStateSet()

Возвращает состояние этого объекта.

Переопределяет:

getAccessibleStateSet в классе Component.AccessibleAWTComponent

Возвращает:

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

См. также:

getAccessibleChildrenCount

public int getAccessibleChildrenCount()

Возвращает количество доступных дочерних элементов объекта. Если все дочерние элементы этого объекта реализуют Accessible, этот метод должен возвращать количество дочерних элементов объекта.

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

getAccessibleChild

public Accessible getAccessibleChild(int i)

Возвращает n-й дочерний элемент Accessible объекта.

Переопределяет:

getAccessibleChild в классе Container.AccessibleAWTContainer

Параметры:

i — индекс дочернего элемента, начиная с нуля

Возвращает:

n-й дочерний элемент Accessible объекта

См. также:

getToolTipText

public String getToolTipText()

Возвращает текст всплывающей подсказки

Определено в:: getToolTipText в интерфейсе AccessibleExtendedComponent
Возвращает:: текст всплывающей подсказки объекта, если он поддерживается; в противном случае — null
С версии:: 1.4

getTitledBorderText

public String getTitledBorderText()

Возвращает текст заголовка границы

Определено в:: getTitledBorderText в интерфейсе AccessibleExtendedComponent
Возвращает:: текст заголовка границы объекта, если он поддерживается; в противном случае — null
С версии:: 1.4

getAccessibleKeyBinding

public AccessibleKeyBinding getAccessibleKeyBinding()

Возвращает сочетания клавиш, связанные с этим объектом

Определено в:

getAccessibleKeyBinding в интерфейсе AccessibleExtendedComponent

Возвращает:

сочетания клавиш объекта, если они поддерживаются; в противном случае — null

С версии:

1.4

См. также:

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.