Класс 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
Краткое описание конструкторов
| Модификатор | Конструктор | Описание |
|---|---|---|
protected |
Хотя класс абстрактный, это должно вызываться всеми подклассами. |
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
void |
addFocusListener |
Добавляет указанного слушателя фокуса для получения событий фокуса от этого компонента. |
void |
addPropertyChangeListener |
Добавляет PropertyChangeListener в список слушателей. |
boolean |
contains |
Проверяет, находится ли указанная точка в пределах границ этого объекта, где координаты x и y точки определены относительно системы координат объекта. |
Accessible |
getAccessibleAt |
Возвращает дочерний Accessible элемент, если он существует, содержащийся в локальных координатах Point. |
Accessible |
getAccessibleChild |
Возвращает 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 |
Получает FontMetrics этого объекта. |
Color |
getForeground() |
Получает цвет переднего плана этого объекта. |
Locale |
getLocale() |
Возвращает локаль этого объекта. |
Point |
getLocation() |
Получает положение объекта относительно родителя в виде точки, определяющей верхний левый угол объекта в пространстве координат экрана. |
Point |
getLocationOnScreen() |
Возвращает положение объекта на экране. |
Dimension |
getSize() |
Возвращает размер этого объекта в виде объекта Dimension. |
boolean |
isEnabled() |
Определяет, активен ли объект. |
boolean |
isFocusTraversable() |
Возвращает, может ли этот объект принять фокус или нет. |
boolean |
isShowing() |
Определяет, отображается ли объект. |
boolean |
isVisible() |
Определяет, видим ли объект. |
void |
removeFocusListener |
Удаляет указанного слушателя фокуса, чтобы он больше не получал события фокуса от этого компонента. |
void |
removePropertyChangeListener |
Удаляет PropertyChangeListener из списка слушателей. |
void |
requestFocus() |
Запрашивает фокус для этого объекта. |
void |
setBackground |
Устанавливает цвет фона этого объекта. |
void |
setBounds |
Устанавливает границы этого объекта в виде объекта Rectangle. |
void |
setCursor |
Устанавливает Cursor этого объекта. |
void |
setEnabled |
Устанавливает состояние активности объекта. |
void |
setFont |
Устанавливает Font этого объекта. |
void |
setForeground |
Устанавливает цвет переднего плана этого объекта. |
void |
setLocation |
Устанавливает положение объекта относительно родителя. |
void |
setSize |
Изменяет размер этого объекта, задавая ширину и высоту. |
void |
setVisible |
Устанавливает состояние видимости объекта. |
Методы, объявленные в классе javax.accessibility.AccessibleContext
firePropertyChange, getAccessibleAction, getAccessibleEditableText, getAccessibleIcon, getAccessibleRelationSet, getAccessibleSelection, getAccessibleTable, getAccessibleText, getAccessibleValue, setAccessibleDescription, setAccessibleName, setAccessibleParent
Краткое описание полей
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()
Получает цвет переднего плана этого объекта.
- Specified by:
-
getForegroundв интерфейсеAccessibleComponent - Returns:
- цвет переднего плана объекта, если поддерживается; в противном случае,
null - See Also:
setForeground
public void setForeground(Color c)
Устанавливает цвет переднего плана этого объекта.
- Specified by:
-
setForegroundв интерфейсеAccessibleComponent - Parameters:
-
c- новыйColorцвета переднего плана - See Also:
getCursor
public Cursor getCursor()
Получает
Cursor этого объекта.- Specified by:
-
getCursorв интерфейсеAccessibleComponent - Returns:
Cursor, если поддерживается; в противном случае,null- See Also:
setCursor
public void setCursor(Cursor cursor)
Устанавливает
Cursor этого объекта. Метод может не иметь визуального эффекта, если реализация платформы Java и/или родная система не поддерживают изменение формы указателя мыши.
- Specified by:
-
setCursorв интерфейсеAccessibleComponent - Parameters:
-
cursor- новыйCursorдля объекта - See Also:
getFont
public Font getFont()
Получает
Font этого объекта.- Specified by:
-
getFontв интерфейсеAccessibleComponent - Returns:
Font, если поддерживается; в противном случае,null- See Also:
setFont
public void setFont(Font f)
Устанавливает
Font этого объекта.- Specified by:
-
setFontв интерфейсеAccessibleComponent - Parameters:
-
f- новыйFontдля объекта - See Also:
getFontMetrics
public FontMetrics getFontMetrics(Font f)
Получает
FontMetrics этого объекта.- Specified by:
-
getFontMetricsв интерфейсеAccessibleComponent - Parameters:
-
f-Font - Returns:
FontMetrics, если поддерживается; в противном случае,null- See Also:
isEnabled
public boolean isEnabled()
Определяет, является ли объект активным.
- Specified by:
-
isEnabledв интерфейсеAccessibleComponent - Returns:
- true, если объект активен; иначе, false
- See Also:
setEnabled
public void setEnabled(boolean b)
Устанавливает состояние активности объекта.
- Specified by:
-
setEnabledв интерфейсеAccessibleComponent - Parameters:
-
b- true, чтобы активировать объект; иначе, деактивировать - See Also:
isVisible
public boolean isVisible()
Определяет, является ли объект видимым. Примечание: это означает, что объект намерен быть видимым; однако, он может фактически не отображаться на экране, потому что один из объектов, в котором содержится этот объект, не является видимым. Чтобы определить, отображается ли объект на экране, используйте
isShowing.- Specified by:
-
isVisibleв интерфейсеAccessibleComponent - Returns:
- true, если объект виден; иначе, false
- See Also:
setVisible
public void setVisible(boolean b)
Устанавливает состояние видимости объекта.
- Specified by:
-
setVisibleв интерфейсеAccessibleComponent - Parameters:
-
b- true, чтобы отобразить этот объект; иначе, скрыть его - See Also:
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:
getLocationOnScreen
public Point getLocationOnScreen()
Возвращает расположение объекта на экране.
- Specified by:
-
getLocationOnScreenв интерфейсеAccessibleComponent - Returns:
- местоположение объекта на экране — может быть
null, если этот объект не находится на экране - See Also:
getLocation
public Point getLocation()
Получает расположение объекта относительно родителя в виде точки, определяющей верхний левый угол объекта в пространстве координат экрана.
- Specified by:
-
getLocationв интерфейсеAccessibleComponent - Returns:
- экземпляр Point, представляющий верхний левый угол границ объекта в пространстве координат экрана;
nullесли этот объект или его родитель не находятся на экране - See Also:
setLocation
public void setLocation(Point p)
Устанавливает расположение объекта относительно родителя.
- Specified by:
-
setLocationв интерфейсеAccessibleComponent - Parameters:
-
p- координаты объекта - See Also:
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://download.java.net/java/early_access/jdk24/docs/api/java.desktop/java/awt/Component.AccessibleAWTComponent.html