Spec-Zone.ru › OpenJDK 24

Класс 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
Внутренний класс компонента, обеспечивающий базовую поддержку доступности. Этот класс не предназначен для непосредственного использования разработчиками приложений, но предназначен только для подклассирования разработчиками компонентов.

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

С:
1.3
См. также:
  • Сериализованная форма

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

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

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

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

Поля, объявленные в классе javax.accessibility.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)
Устанавливает состояние видимости объекта.

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

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

Методы, объявленные в классе java.lang.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 - слушатель изменений свойств, который нужно добавить
См. также:
  • AccessibleContext.ACCESSIBLE_NAME_PROPERTY
  • AccessibleContext.ACCESSIBLE_DESCRIPTION_PROPERTY
  • AccessibleContext.ACCESSIBLE_STATE_PROPERTY
  • AccessibleContext.ACCESSIBLE_VALUE_PROPERTY
  • AccessibleContext.ACCESSIBLE_SELECTION_PROPERTY
  • AccessibleContext.ACCESSIBLE_TEXT_PROPERTY
  • AccessibleContext.ACCESSIBLE_VISIBLE_DATA_PROPERTY

removePropertyChangeListener

public void removePropertyChangeListener(PropertyChangeListener listener)
Удаляет PropertyChangeListener из списка слушателей. Это удаляет PropertyChangeListener, который был зарегистрирован для всех свойств.
Переопределяет:
removePropertyChangeListener в классе AccessibleContext
Параметры:
listener - PropertyChangeListener, который нужно удалить

getAccessibleName

public String getAccessibleName()
Получает доступное имя этого объекта. Это почти никогда не должно возвращать java.awt.Component.getName(), так как это, как правило, не локализованное имя и не имеет смысла для пользователя. Если объект по своей сути является текстовым объектом (например, элемент меню), доступное имя должно быть текстом объекта (например, «сохранить»). Если у объекта есть всплывающая подсказка, текст подсказки также может быть подходящей строкой для возврата.
Переопределяет:
getAccessibleName в классе AccessibleContext
Возвращает:
локализованное имя объекта — может быть null, если у этого объекта нет имени
См. также:
  • AccessibleContext.setAccessibleName(java.lang.String)

getAccessibleDescription

public String getAccessibleDescription()
Получает доступное описание этого объекта. Это должно быть краткое, локализованное описание того, что представляет собой этот объект — каково его значение для пользователя. Если у объекта есть всплывающая подсказка, текст подсказки может быть подходящей строкой для возврата, при условии, что он содержит краткое описание объекта (вместо просто имени объекта — например, значок «Сохранить» на панели инструментов, у которого текст подсказки был «сохранить», не должен возвращать текст подсказки в качестве описания, а что-то вроде «Сохраняет текущий текстовый документ» вместо этого).
Переопределяет:
getAccessibleDescription в классе AccessibleContext
Возвращает:
локализованное описание объекта — может быть null, если у этого объекта нет описания
См. также:
  • AccessibleContext.setAccessibleDescription(java.lang.String)

getAccessibleRole

public AccessibleRole getAccessibleRole()
Получает роль этого объекта.
Указано в:
getAccessibleRole в классе AccessibleContext
Возвращает:
экземпляр AccessibleRole, описывающий роль объекта
См. также:
  • AccessibleRole

getAccessibleStateSet

public AccessibleStateSet getAccessibleStateSet()
Получает состояние этого объекта.
Указано в:
getAccessibleStateSet в классе AccessibleContext
Возвращает:
экземпляр AccessibleStateSet, содержащий текущий набор состояний объекта
См. также:
  • AccessibleState

getAccessibleParent

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

getAccessibleIndexInParent

public int getAccessibleIndexInParent()
Получает индекс этого объекта в его доступном родительском элементе.
Указано в:
getAccessibleIndexInParent в классе AccessibleContext
Возвращает:
индекс этого объекта в его родительском элементе; или -1, если у этого объекта нет доступного родительского элемента
См. также:
  • getAccessibleParent()

getAccessibleChildrenCount

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

getAccessibleChild

public Accessible getAccessibleChild(int i)
Возвращает n-ый дочерний элемент Accessible объекта.
Указано в:
getAccessibleChild в классе AccessibleContext
Параметры:
i - индекс дочернего элемента, отсчитываемый от нуля
Возвращает:
n-ый дочерний элемент Accessible объекта
См. также:
  • AccessibleContext.getAccessibleChildrenCount()

getLocale

public Locale getLocale()
Возвращает языковой стандарт этого объекта.
Указано в:
getLocale в классе AccessibleContext
Возвращает:
языковой стандарт этого объекта

getAccessibleComponent

public AccessibleComponent getAccessibleComponent()
Получает компонент AccessibleComponent, связанный с этим объектом, если таковой существует. В противном случае возвращает null.
Переопределяет:
getAccessibleComponent в классе AccessibleContext
Возвращает:
компонент
См. также:
  • AccessibleComponent

getBackground

public Color getBackground()
Получает цвет фона этого объекта.
Указано в:
getBackground в интерфейсе AccessibleComponent
Возвращает:
цвет фона, если поддерживается, объекта; в противном случае, null
См. также:
  • AccessibleComponent.setBackground(java.awt.Color)

setBackground

public void setBackground(Color c)
Устанавливает цвет фона этого объекта. (Для прозрачности см. isOpaque.)
Указано в:
setBackground в интерфейсе AccessibleComponent
Параметры:
c - новый Color для фона
См. также:
  • Component.isOpaque()

getForeground

public Color getForeground()
Получает цвет переднего плана этого объекта.
Specified by:
getForeground в интерфейсе AccessibleComponent
Returns:
цвет переднего плана объекта, если поддерживается; в противном случае, null
See Also:
  • AccessibleComponent.setForeground(java.awt.Color)

setForeground

public void setForeground(Color c)
Устанавливает цвет переднего плана этого объекта.
Specified by:
setForeground в интерфейсе AccessibleComponent
Parameters:
c - новый Color цвета переднего плана
See Also:
  • AccessibleComponent.getForeground()

getCursor

public Cursor getCursor()
Получает Cursor этого объекта.
Specified by:
getCursor в интерфейсе AccessibleComponent
Returns:
Cursor, если поддерживается; в противном случае, null
See Also:
  • AccessibleComponent.setCursor(java.awt.Cursor)

setCursor

public void setCursor(Cursor cursor)
Устанавливает Cursor этого объекта.

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

Specified by:
setCursor в интерфейсе AccessibleComponent
Parameters:
cursor - новый Cursor для объекта
See Also:
  • AccessibleComponent.getCursor()

getFont

public Font getFont()
Получает Font этого объекта.
Specified by:
getFont в интерфейсе AccessibleComponent
Returns:
Font, если поддерживается; в противном случае, null
See Also:
  • AccessibleComponent.setFont(java.awt.Font)

setFont

public void setFont(Font f)
Устанавливает Font этого объекта.
Specified by:
setFont в интерфейсе AccessibleComponent
Parameters:
f - новый Font для объекта
See Also:
  • AccessibleComponent.getFont()

getFontMetrics

public FontMetrics getFontMetrics(Font f)
Получает FontMetrics этого объекта.
Specified by:
getFontMetrics в интерфейсе AccessibleComponent
Parameters:
f - Font
Returns:
FontMetrics, если поддерживается; в противном случае, null
See Also:
  • getFont()

isEnabled

public boolean isEnabled()
Определяет, является ли объект активным.
Specified by:
isEnabled в интерфейсе AccessibleComponent
Returns:
true, если объект активен; иначе, false
See Also:
  • AccessibleComponent.setEnabled(boolean)
  • AccessibleContext.getAccessibleStateSet()
  • AccessibleState.ENABLED
  • AccessibleStateSet

setEnabled

public void setEnabled(boolean b)
Устанавливает состояние активности объекта.
Specified by:
setEnabled в интерфейсе AccessibleComponent
Parameters:
b - true, чтобы активировать объект; иначе, деактивировать
See Also:
  • AccessibleComponent.isEnabled()

isVisible

public boolean isVisible()
Определяет, является ли объект видимым. Примечание: это означает, что объект намерен быть видимым; однако, он может фактически не отображаться на экране, потому что один из объектов, в котором содержится этот объект, не является видимым. Чтобы определить, отображается ли объект на экране, используйте isShowing.
Specified by:
isVisible в интерфейсе AccessibleComponent
Returns:
true, если объект виден; иначе, false
See Also:
  • AccessibleComponent.setVisible(boolean)
  • AccessibleContext.getAccessibleStateSet()
  • AccessibleState.VISIBLE
  • AccessibleStateSet

setVisible

public void setVisible(boolean b)
Устанавливает состояние видимости объекта.
Specified by:
setVisible в интерфейсе AccessibleComponent
Parameters:
b - true, чтобы отобразить этот объект; иначе, скрыть его
See Also:
  • AccessibleComponent.isVisible()

isShowing

public boolean isShowing()
Определяет, отображается ли объект. Это определяется путем проверки видимости объекта и предков объекта. Примечание: это вернет true, даже если объект скрыт другим (например, он оказывается под выпадающим меню).
Specified by:
isShowing в интерфейсе AccessibleComponent
Returns:
true, если объект отображается; иначе, false

contains

public boolean contains(Point p)
Проверяет, находится ли указанная точка внутри границ этого объекта, где координаты x и y точки определены относительно системы координат объекта.
Specified by:
contains в интерфейсе AccessibleComponent
Parameters:
p - Point относительно системы координат объекта
Returns:
true, если объект содержит Point; иначе false
See Also:
  • AccessibleComponent.getBounds()

getLocationOnScreen

public Point getLocationOnScreen()
Возвращает расположение объекта на экране.
Specified by:
getLocationOnScreen в интерфейсе AccessibleComponent
Returns:
местоположение объекта на экране — может быть null, если этот объект не находится на экране
See Also:
  • AccessibleComponent.getBounds()
  • AccessibleComponent.getLocation()

getLocation

public Point getLocation()
Получает расположение объекта относительно родителя в виде точки, определяющей верхний левый угол объекта в пространстве координат экрана.
Specified by:
getLocation в интерфейсе AccessibleComponent
Returns:
экземпляр Point, представляющий верхний левый угол границ объекта в пространстве координат экрана; null если этот объект или его родитель не находятся на экране
See Also:
  • AccessibleComponent.getBounds()
  • AccessibleComponent.getLocationOnScreen()

setLocation

public void setLocation(Point p)
Устанавливает расположение объекта относительно родителя.
Specified by:
setLocation в интерфейсе AccessibleComponent
Parameters:
p - координаты объекта
See Also:
  • AccessibleComponent.getLocation()

getBounds

public Rectangle getBounds()
Получает границы этого объекта в виде объекта Rectangle. Границы определяют ширину, высоту и расположение этого объекта относительно его родительского элемента.
Указано:
getBounds в интерфейсе AccessibleComponent
Возвращает:
прямоугольник, указывающий границы этого компонента; null если этот объект не отображается на экране
См. также:
  • AccessibleComponent.contains(java.awt.Point)

setBounds

public void setBounds(Rectangle r)
Устанавливает границы этого объекта в форме объекта Rectangle. Границы определяют ширину, высоту и расположение этого объекта относительно его родительского элемента.
Указано:
setBounds в интерфейсе AccessibleComponent
Параметры:
r - прямоугольник, указывающий границы этого компонента
См. также:
  • AccessibleComponent.getBounds()

getSize

public Dimension getSize()
Возвращает размер этого объекта в виде объекта Dimension. Поле height объекта Dimension содержит высоту этого объекта, а поле width объекта Dimension содержит ширину этого объекта.
Указано:
getSize в интерфейсе AccessibleComponent
Возвращает:
объект Dimension, указывающий размер этого компонента; null если этот объект не отображается на экране
См. также:
  • AccessibleComponent.setSize(java.awt.Dimension)

setSize

public void setSize(Dimension d)
Изменяет размеры этого объекта так, чтобы его ширина и высота были заданными.
Указано:
setSize в интерфейсе AccessibleComponent
Параметры:
d - размер, определяющий новый размер объекта
См. также:
  • AccessibleComponent.getSize()

getAccessibleAt

public Accessible getAccessibleAt(Point p)
Возвращает дочерний Accessible объект, если он существует, по локальным координатам Point. В противном случае возвращает null.
Указано:
getAccessibleAt в интерфейсе AccessibleComponent
Параметры:
p - точка, определяющая верхний левый угол Accessible, заданная в системе координат родительского элемента объекта
Возвращает:
Accessible, если он существует, по указанным координатам; иначе null

isFocusTraversable

public boolean isFocusTraversable()
Возвращает, может ли этот объект получить фокус или нет.
Указано:
isFocusTraversable в интерфейсе AccessibleComponent
Возвращает:
true, если объект может получить фокус; в противном случае false
См. также:
  • AccessibleContext.getAccessibleStateSet()
  • AccessibleState.FOCUSABLE
  • AccessibleState.FOCUSED
  • AccessibleStateSet

requestFocus

public void requestFocus()
Запрашивает фокус для этого объекта.
Указано:
requestFocus в интерфейсе AccessibleComponent
См. также:
  • AccessibleComponent.isFocusTraversable()

addFocusListener

public void addFocusListener(FocusListener l)
Добавляет указанного слушателя фокуса для получения событий фокуса от этого компонента.
Указано:
addFocusListener в интерфейсе AccessibleComponent
Параметры:
l - слушатель фокуса
См. также:
  • AccessibleComponent.removeFocusListener(java.awt.event.FocusListener)

removeFocusListener

public void removeFocusListener(FocusListener l)
Удаляет указанного слушателя фокуса, чтобы он больше не получал события фокуса от этого компонента.
Указано:
removeFocusListener в интерфейсе AccessibleComponent
Параметры:
l - слушатель фокуса
См. также:
  • AccessibleComponent.addFocusListener(java.awt.event.FocusListener)

© 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://download.java.net/java/early_access/jdk24/docs/api/java.desktop/java/awt/Component.AccessibleAWTComponent.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API