Класс Component.AccessibleAWTComponent

java.lang.Object

javax.accessibility.AccessibleContext

java.awt.Component.AccessibleAWTComponent

Все реализуемые интерфейсы:: Serializable, AccessibleComponent

Непосредственные известные подклассы:: Box.Filler.AccessibleBoxFiller, Button.AccessibleAWTButton, Canvas.AccessibleAWTCanvas, Checkbox.AccessibleAWTCheckbox, Choice.AccessibleAWTChoice, Container.AccessibleAWTContainer, Label.AccessibleAWTLabel, List.AccessibleAWTList, List.AccessibleAWTList.AccessibleAWTListChild, Scrollbar.AccessibleAWTScrollBar, TextComponent.AccessibleAWTTextComponent

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

protected abstract class Component.AccessibleAWTComponent extends AccessibleContext implements Serializable, AccessibleComponent

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

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

Начиная с версии:

1.3

См. также:

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

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

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

Модификатор и тип	Поле	Описание
`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

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

AccessibleAWTComponent()

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

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

Модификатор и тип	Метод	Описание
`void`	`addFocusListener(FocusListener l)`	Добавляет указанный обработчик фокуса, чтобы получать события фокуса от этого компонента.
`void`	`addPropertyChangeListener(PropertyChangeListener listener)`	Добавляет `PropertyChangeListener` в список обработчиков.
`boolean`	`contains(Point p)`	Проверяет, находится ли указанная точка в пределах границ этого объекта; координаты x и y точки задаются относительно системы координат объекта.
`Accessible`	`getAccessibleAt(Point p)`	Возвращает дочерний элемент `Accessible`, если он существует и находится в локальной координате `Point`.
`Accessible`	`getAccessibleChild(int i)`	Возвращает n-й дочерний элемент `Accessible` объекта.
`int`	`getAccessibleChildrenCount()`	Возвращает количество дочерних элементов, поддерживающих специальные возможности, в объекте.
`AccessibleComponent`	`getAccessibleComponent()`	Получает `AccessibleComponent`, связанный с этим объектом, если он существует.
`String`	`getAccessibleDescription()`	Получает описание специальных возможностей этого объекта.
`int`	`getAccessibleIndexInParent()`	Получает индекс этого объекта в родительском объекте, поддерживающем специальные возможности.
`String`	`getAccessibleName()`	Получает имя этого объекта для специальных возможностей.
`Accessible`	`getAccessibleParent()`	Получает родительский объект `Accessible`.
`AccessibleRole`	`getAccessibleRole()`	Получает роль этого объекта.
`AccessibleStateSet`	`getAccessibleStateSet()`	Получает состояние этого объекта.
`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`	`removePropertyChangeListener(PropertyChangeListener listener)`	Удаляет PropertyChangeListener из списка обработчиков.
`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

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

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

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

accessibleAWTComponentHandler

protected ComponentListener accessibleAWTComponentHandler

Слушатель компонента для отслеживания событий отображения, скрытия и изменения размера и преобразования их в события PropertyChange.

accessibleAWTFocusHandler

protected FocusListener accessibleAWTFocusHandler

Слушатель для отслеживания событий фокуса и преобразования их в события PropertyChange.

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

AccessibleAWTComponent

protected AccessibleAWTComponent()

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

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

addPropertyChangeListener

public void addPropertyChangeListener(PropertyChangeListener listener)

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

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

addPropertyChangeListener в классе AccessibleContext

Параметры:

listener - слушатель изменений свойств, который нужно добавить

См. также:

removePropertyChangeListener

public void removePropertyChangeListener(PropertyChangeListener listener)

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

Переопределяет:: removePropertyChangeListener в классе AccessibleContext
Параметры:: listener - PropertyChangeListener, который нужно удалить

getAccessibleName

public String getAccessibleName()

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

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

getAccessibleName в классе AccessibleContext

Возвращает:

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

См. также:

getAccessibleDescription

public String getAccessibleDescription()

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

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

getAccessibleDescription в классе AccessibleContext

Возвращает:

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

См. также:

getAccessibleRole

public AccessibleRole getAccessibleRole()

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

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

getAccessibleRole в классе AccessibleContext

Возвращает:

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

См. также:

getAccessibleStateSet

public AccessibleStateSet getAccessibleStateSet()

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

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

getAccessibleStateSet в классе AccessibleContext

Возвращает:

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

См. также:

getAccessibleParent

public Accessible getAccessibleParent()

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

Переопределяет:: getAccessibleParent в классе AccessibleContext
Возвращает:: Accessible родительский объект этого объекта — может быть null, если у этого объекта нет Accessible родительского объекта

getAccessibleIndexInParent

public int getAccessibleIndexInParent()

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

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

getAccessibleIndexInParent в классе AccessibleContext

Возвращает:

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

См. также:

getAccessibleChildrenCount

public int getAccessibleChildrenCount()

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

Определено в:: getAccessibleChildrenCount в классе AccessibleContext
Возвращает:: количество доступных дочерних объектов

getAccessibleChild

public Accessible getAccessibleChild(int i)

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

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

getAccessibleChild в классе AccessibleContext

Параметры:

i - отсчитываемый от нуля индекс дочернего объекта

Возвращает:

n-й Accessible дочерний объект

См. также:

getLocale

public Locale getLocale()

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

Определено в:: getLocale в классе AccessibleContext
Возвращает:: локаль этого объекта

getAccessibleComponent

public AccessibleComponent getAccessibleComponent()

Возвращает AccessibleComponent, связанный с этим объектом, если он существует. В противном случае возвращает null.

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

getAccessibleComponent в классе AccessibleContext

Возвращает:

компонент

См. также:

getBackground

public Color getBackground()

Возвращает цвет фона этого объекта.

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

getBackground в интерфейсе AccessibleComponent

Возвращает:

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

См. также:

setBackground

public void setBackground(Color c)

Устанавливает цвет фона этого объекта. (Информацию о прозрачности см. в isOpaque.)

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

setBackground в интерфейсе AccessibleComponent

Параметры:

c - новый Color фона

См. также:

getForeground

public Color getForeground()

Возвращает цвет переднего плана этого объекта.

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

getForeground в интерфейсе AccessibleComponent

Возвращает:

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

См. также:

setForeground

public void setForeground(Color c)

Устанавливает цвет переднего плана этого объекта.

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

setForeground в интерфейсе AccessibleComponent

Параметры:

c - новый Color переднего плана

См. также:

getCursor

public Cursor getCursor()

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

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

getCursor в интерфейсе AccessibleComponent

Возвращает:

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

См. также:

setCursor

public void setCursor(Cursor cursor)

Устанавливает Cursor этого объекта.

Метод может не оказывать визуального эффекта, если реализация платформы Java и/или собственная система не поддерживают изменение формы курсора мыши.

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

setCursor в интерфейсе AccessibleComponent

Параметры:

cursor - новый Cursor объекта

См. также:

getFont

public Font getFont()

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

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

getFont в интерфейсе AccessibleComponent

Возвращает:

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

См. также:

setFont

public void setFont(Font f)

Устанавливает Font этого объекта.

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

setFont в интерфейсе AccessibleComponent

Параметры:

f - новый Font объекта

См. также:

getFontMetrics

public FontMetrics getFontMetrics(Font f)

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

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

getFontMetrics в интерфейсе AccessibleComponent

Параметры:

f - Font

Возвращает:

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

См. также:

isEnabled

public boolean isEnabled()

Определяет, включен ли объект.

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

isEnabled в интерфейсе AccessibleComponent

Возвращает:

true, если объект включен; в противном случае — false

См. также:

setEnabled

public void setEnabled(boolean b)

Устанавливает состояние включения объекта.

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

setEnabled в интерфейсе AccessibleComponent

Параметры:

b - если true, включает этот объект; в противном случае отключает его

См. также:

isVisible

public boolean isVisible()

Определяет, видим ли объект. Примечание: это означает, что объект должен быть видимым; однако он может фактически не отображаться на экране, если один из содержащих его объектов невидим. Чтобы определить, отображается ли объект на экране, используйте isShowing.

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

isVisible в интерфейсе AccessibleComponent

Возвращает:

true, если объект видим; в противном случае — false

См. также:

setVisible

public void setVisible(boolean b)

Устанавливает состояние видимости объекта.

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

setVisible в интерфейсе AccessibleComponent

Параметры:

b - если true, отображает этот объект; в противном случае скрывает его

См. также:

isShowing

public boolean isShowing()

Определяет, отображается ли объект. Это определяется путем проверки видимости объекта и его предков. Примечание: метод вернет true, даже если объект закрыт другим объектом (например, если он оказался под раскрытым меню).

Определено в:: isShowing в интерфейсе AccessibleComponent
Возвращает:: true, если объект отображается; в противном случае — false

contains

public boolean contains(Point p)

Проверяет, находится ли указанная точка в пределах границ этого объекта; координаты x и y точки задаются относительно системы координат объекта.

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

contains в интерфейсе AccessibleComponent

Параметры:

p - Point относительно системы координат объекта

Возвращает:

true, если объект содержит Point; в противном случае — false

См. также:

getLocationOnScreen

public Point getLocationOnScreen()

Возвращает местоположение объекта на экране.

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

getLocationOnScreen в интерфейсе AccessibleComponent

Возвращает:

местоположение объекта на экране — может быть null, если этот объект не находится на экране

См. также:

getLocation

public Point getLocation()

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

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

getLocation в интерфейсе AccessibleComponent

Возвращает:

экземпляр Point, представляющий верхний левый угол границ объекта в системе координат экрана; null, если этот объект или его родительский объект не находятся на экране

См. также:

setLocation

public void setLocation(Point p)

Устанавливает местоположение объекта относительно родительского объекта.

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

setLocation в интерфейсе AccessibleComponent

Параметры:

p - координаты объекта

См. также:

getBounds

public Rectangle getBounds()

Возвращает границы этого объекта в виде объекта Rectangle. Границы задают ширину, высоту и местоположение объекта относительно его родительского объекта.

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

getBounds в интерфейсе AccessibleComponent

Возвращает:

прямоугольник, задающий границы этого компонента; null, если этот объект не находится на экране

См. также:

setBounds

public void setBounds(Rectangle r)

Устанавливает границы этого объекта в виде объекта Rectangle. Границы задают ширину, высоту и местоположение объекта относительно его родительского объекта.

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

setBounds в интерфейсе AccessibleComponent

Параметры:

r - прямоугольник, задающий границы этого компонента

См. также:

getSize

public Dimension getSize()

Возвращает размер этого объекта в виде объекта Dimension. Поле height объекта Dimension содержит высоту этого объекта, а поле width объекта Dimension — его ширину.

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

getSize в интерфейсе AccessibleComponent

Возвращает:

объект Dimension, задающий размер этого компонента; null, если этот объект не находится на экране

См. также:

setSize

public void setSize(Dimension d)

Изменяет размер этого объекта, задавая его ширину и высоту.

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

setSize в интерфейсе AccessibleComponent

Параметры:

d - размер, задающий новые размеры объекта

См. также:

getAccessibleAt

public Accessible getAccessibleAt(Point p)

Возвращает Accessible дочерний объект, если таковой имеется, содержащийся в локальной координате Point. В противном случае возвращает null.

Определено в:: getAccessibleAt в интерфейсе AccessibleComponent
Параметры:: p - точка, задающая верхний левый угол Accessible в системе координат родительского объекта
Возвращает:: Accessible, если он существует, в указанном местоположении; иначе — null

isFocusTraversable

public boolean isFocusTraversable()

Возвращает, может ли этот объект получать фокус.

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

isFocusTraversable в интерфейсе AccessibleComponent

Возвращает:

true, если объект может получать фокус; в противном случае — false

См. также:

requestFocus

public void requestFocus()

Запрашивает фокус для этого объекта.

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

requestFocus в интерфейсе AccessibleComponent

См. также:

addFocusListener

public void addFocusListener(FocusListener l)

Добавляет указанный слушатель фокуса, чтобы получать события фокуса от этого компонента.

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

addFocusListener в интерфейсе AccessibleComponent

Параметры:

l - слушатель фокуса

См. также:

removeFocusListener

public void removeFocusListener(FocusListener l)

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

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

removeFocusListener в интерфейсе AccessibleComponent

Параметры:

l - слушатель фокуса

См. также:

© 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.
https://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/java/awt/Component.AccessibleAWTComponent.html