Класс 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 |
protected FocusListener |
accessibleAWTFocusHandler |
Поля, унаследованные от класса 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 |
AccessibleAWTComponent() Хотя класс абстрактный, его должен вызывать каждый подкласс. |
Методы
| Модификатор и тип | Метод и описание |
|---|---|
void |
addFocusListener(FocusListener l) Добавляет указанного слушателя фокуса для получения событий фокуса от этого компонента. |
void |
addPropertyChangeListener(PropertyChangeListener listener) Добавляет |
boolean |
contains(Point p) Проверяет, находится ли указанная точка внутри границ этого объекта, где координаты x и y точки определены как относительные к системе координат объекта. |
Accessible |
getAccessibleAt(Point p) Возвращает |
Accessible |
getAccessibleChild(int i) Возвращает n-й |
int |
getAccessibleChildrenCount() Возвращает количество доступных дочерних элементов в объекте. |
AccessibleComponent |
getAccessibleComponent() Получает |
String |
getAccessibleDescription() Получает доступное описание этого объекта. |
int |
getAccessibleIndexInParent() Получает индекс этого объекта в его доступном родительском элементе. |
String |
getAccessibleName() Получает доступное имя этого объекта. |
Accessible |
getAccessibleParent() Получает |
AccessibleRole |
getAccessibleRole() Получает роль этого объекта. |
AccessibleStateSet |
getAccessibleStateSet() Получает состояние этого объекта. |
Color |
getBackground() Получает цвет фона этого объекта. |
Rectangle |
getBounds() Получает границы этого объекта в виде объекта Rectangle. |
Cursor |
getCursor() Получает |
Font |
getFont() Получает |
FontMetrics |
getFontMetrics(Font f) Получает |
Color |
getForeground() Получает цвет переднего плана этого объекта. |
Locale |
getLocale() Возвращает локаль этого объекта. |
Point |
getLocation() Получает расположение объекта относительно родителя в виде точки, определяющей верхний левый угол объекта в системе координат экрана. |
Point |
getLocationOnScreen() Возвращает расположение объекта на экране. |
Dimension |
getSize() Возвращает размер этого объекта в виде объекта |
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) Устанавливает границы этого объекта в виде объекта |
void |
setCursor(Cursor cursor) Устанавливает |
void |
setEnabled(boolean b) Устанавливает состояние включения объекта. |
void |
setFont(Font f) Устанавливает |
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
accessibleAWTFocusHandler
protected FocusListener accessibleAWTFocusHandler
Конструкторы
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()
Получает цвет переднего плана этого объекта.
- Определено в:
-
getForegroundв интерфейсеAccessibleComponent - Возвращает:
- цвет переднего плана, если поддерживается, объекта; в противном случае,
null - См. также:
AccessibleComponent.setForeground(java.awt.Color)
setForeground
public void setForeground(Color c)
Устанавливает цвет переднего плана этого объекта.
- Определено в:
-
setForegroundв интерфейсеAccessibleComponent - Параметры:
-
c- новыйColorдля переднего плана - См. также:
AccessibleComponent.getForeground()
getCursor
public Cursor getCursor()
Получает Cursor этого объекта.
- Определено в:
-
getCursorв интерфейсеAccessibleComponent - Возвращает:
Cursor, если поддерживается, объекта; в противном случае,null- См. также:
AccessibleComponent.setCursor(java.awt.Cursor)
setCursor
public void setCursor(Cursor cursor)
Устанавливает Cursor этого объекта.
Метод может не иметь визуального эффекта, если реализация платформы Java и/или системные настройки не поддерживают изменение формы курсора мыши.
- Определено в:
-
setCursorв интерфейсеAccessibleComponent - Параметры:
-
cursor- новыйCursorдля объекта - См. также:
AccessibleComponent.getCursor()
getFont
public Font getFont()
Получает Font этого объекта.
- Определено в:
-
getFontв интерфейсеAccessibleComponent - Возвращает:
Font, если поддерживается, для объекта; в противном случае,null- См. также:
AccessibleComponent.setFont(java.awt.Font)
setFont
public void setFont(Font f)
Устанавливает Font этого объекта.
- Указано:
-
setFontв интерфейсеAccessibleComponent - Параметры:
-
f- новыйFontдля объекта - См. также:
AccessibleComponent.getFont()
getFontMetrics
public FontMetrics getFontMetrics(Font f)
Получает FontMetrics этого объекта.
- Указано:
-
getFontMetricsв интерфейсеAccessibleComponent - Параметры:
-
f-Font - Возвращает:
FontMetrics, если поддерживается, объект; в противном случае,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-Pointотносительно системы координат объекта - Возвращает:
- true, если объект содержит
Point; в противном случае 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. Поле высоты объекта Dimension содержит высоту объекта, а поле ширины объекта 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, 2020, 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.