Spec-Zone.ru › OpenJDK 21

Класс 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 в список слушателей.
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, если у этого объекта нет родительского объекта

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

getCursor

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

setCursor

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

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

Определено в:
setCursor в интерфейсе AccessibleComponent
Параметры:
cursor - новый курсор объекта
См. также:
  • AccessibleComponent.getCursor()

getFont

public Font getFont()
Возвращает шрифт этого объекта.
Определено в:
getFont в интерфейсе AccessibleComponent
Возвращает:
шрифт объекта, если поддерживается; иначе, null
См. также:
  • AccessibleComponent.setFont(java.awt.Font)

setFont

public void setFont(Font f)
Устанавливает шрифт этого объекта.
Определено в:
setFont в интерфейсе AccessibleComponent
Параметры:
f - новый шрифт объекта
См. также:
  • AccessibleComponent.getFont()

getFontMetrics

public FontMetrics getFontMetrics(Font f)
Возвращает метрику шрифта этого объекта.
Определено в:
getFontMetrics в интерфейсе AccessibleComponent
Параметры:
f - шрифт
Возвращает:
метрику шрифта, если поддерживается; иначе, null
См. также:
  • getFont()

isEnabled

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

setEnabled

public void setEnabled(boolean b)
Устанавливает состояние активности объекта.
Определено в:
setEnabled в интерфейсе AccessibleComponent
Параметры:
b - true, чтобы активировать объект; иначе, деактивировать
См. также:
  • AccessibleComponent.isEnabled()

isVisible

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

setVisible

public void setVisible(boolean b)
Устанавливает состояние видимости объекта.
Определено в:
setVisible в интерфейсе AccessibleComponent
Параметры:
b - true, чтобы показать объект; иначе, скрыть
См. также:
  • AccessibleComponent.isVisible()

isShowing

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

contains

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

getLocationOnScreen

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

getLocation

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

setLocation

public void setLocation(Point p)
Устанавливает расположение объекта относительно родителя.
Определено в:
setLocation в интерфейсе AccessibleComponent
Параметры:
p - координаты объекта
См. также:
  • 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, 2023, 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/21/docs/api/java.desktop/java/awt/Component.AccessibleAWTComponent.html

Spec-Zone.ru

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