Spec-Zone.ru › OpenJDK 17

Класс 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
Обработчик событий Component для отслеживания событий отображения/скрытия/изменения размера и преобразования их в события 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 в список слушателей.
Overrides:
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, который был зарегистрирован для всех свойств.
Overrides:
removePropertyChangeListener в классе AccessibleContext
Параметры:
listener - PropertyChangeListener, который нужно удалить

getAccessibleName

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

getAccessibleDescription

public String getAccessibleDescription()
Получает доступное описание этого объекта. Это должно быть краткое локализованное описание того, что представляет собой этот объект — что он означает для пользователя. Если у объекта есть всплывающая подсказка, текст всплывающей подсказки может быть подходящей строкой для возврата, если она содержит краткое описание объекта (вместо просто имени объекта — например, для значка «Сохранить» на панели инструментов, у которого всплывающая подсказка была «сохранить», не следует возвращать текст всплывающей подсказки в качестве описания, а что-то вроде «Сохраняет текущий текстовый документ»).
Overrides:
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, этот метод должен просто вернуть getParent.
Overrides:
getAccessibleParent в классе AccessibleContext
Возвращает:
родительский объект этого объекта — может быть null, если у этого объекта нет родительского объекта Accessible

getAccessibleIndexInParent

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

getAccessibleChildrenCount

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

getAccessibleChild

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

getLocale

public Locale getLocale()
Возвращает локаль этого объекта.
Определяется:
getLocale в классе AccessibleContext
Возвращает:
локаль этого объекта

getAccessibleComponent

public AccessibleComponent getAccessibleComponent()
Получает связанный с этим объектом компонент, если он существует. В противном случае возвращает null.
Overrides:
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()
Получает цвет переднего плана этого объекта.
Определяется:
getForeground в интерфейсе AccessibleComponent
Возвращает:
цвет переднего плана объекта, если он поддерживается; в противном случае, null
См. также:
  • AccessibleComponent.setForeground(java.awt.Color)
END_OF_DOCUMENT_MARKER

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. Границы задают ширину, высоту и расположение этого объекта относительно его родительского элемента.
Specified by:
getBounds в интерфейсе AccessibleComponent
Returns:
прямоугольник, указывающий границы этого компонента; null если этот объект не на экране
See Also:
  • AccessibleComponent.contains(java.awt.Point)

setBounds

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

getSize

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

setSize

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

getAccessibleAt

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

isFocusTraversable

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

requestFocus

public void requestFocus()
Запрашивает фокус для этого объекта.
Specified by:
requestFocus в интерфейсе AccessibleComponent
See Also:
  • AccessibleComponent.isFocusTraversable()

addFocusListener

public void addFocusListener(FocusListener l)
Добавляет указанный обработчик событий фокуса для получения событий фокуса от этого компонента.
Specified by:
addFocusListener в интерфейсе AccessibleComponent
Parameters:
l - обработчик событий фокуса
See Also:
  • AccessibleComponent.removeFocusListener(java.awt.event.FocusListener)

removeFocusListener

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

© 1993, 2021, 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/17/docs/api/java.desktop/java/awt/Component.AccessibleAWTComponent.html

Spec-Zone.ru

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