Класс 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 в список слушателей.- Overrides:
-
addPropertyChangeListenerв классеAccessibleContext - Параметры:
-
listener- слушатель изменений свойств, который нужно добавить - См. также:
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, если у этого объекта нет имени - См. также:
getAccessibleDescription
public String getAccessibleDescription()
Получает доступное описание этого объекта. Это должно быть краткое, локализованное описание того, что представляет собой этот объект — его значение для пользователя. Если у объекта есть всплывающая подсказка, текст всплывающей подсказки может быть подходящей строкой для возврата, предполагая, что она содержит краткое описание объекта (вместо просто имени объекта — например, для значка «Сохранить» на панели инструментов, у которого был текст всплывающей подсказки «сохранить», не следует возвращать текст всплывающей подсказки как описание, а что-то вроде «Сохраняет текущий текстовый документ» вместо этого).
- Overrides:
-
getAccessibleDescriptionв классеAccessibleContext - Возвращает:
- локализованное описание объекта — может быть
null, если у этого объекта нет описания - См. также:
getAccessibleRole
public AccessibleRole getAccessibleRole()
Получает роль этого объекта.
- Определяется в:
-
getAccessibleRoleв классеAccessibleContext - Возвращает:
- экземпляр
AccessibleRole, описывающий роль объекта - См. также:
getAccessibleStateSet
public AccessibleStateSet getAccessibleStateSet()
Получает состояние этого объекта.
- Определяется в:
-
getAccessibleStateSetв классеAccessibleContext - Возвращает:
- экземпляр
AccessibleStateSet, содержащий текущий набор состояний объекта - См. также:
getAccessibleParent
public Accessible getAccessibleParent()
Получает родительский объект для данного объекта. Если родитель этого объекта реализует
Accessible, этот метод должен просто возвращать getParent.- Overrides:
-
getAccessibleParentв классеAccessibleContext - Возвращает:
- родительский объект для данного объекта — может быть
null, если у этого объекта нет родительского объекта
getAccessibleIndexInParent
public int getAccessibleIndexInParent()
Получает индекс этого объекта в его родительском объекте.
- Определяется в:
-
getAccessibleIndexInParentв классеAccessibleContext - Возвращает:
- индекс этого объекта в его родительском объекте; или -1, если у этого объекта нет родительского объекта
- См. также:
getAccessibleChildrenCount
public int getAccessibleChildrenCount()
Возвращает количество доступных дочерних элементов в объекте. Если все дочерние элементы этого объекта реализуют
Accessible, то этот метод должен возвращать количество дочерних элементов этого объекта.- Определяется в:
-
getAccessibleChildrenCountв классеAccessibleContext - Возвращает:
- количество доступных дочерних элементов в объекте
getAccessibleChild
public Accessible getAccessibleChild(int i)
Возвращает n-й дочерний элемент объекта.
- Определяется в:
-
getAccessibleChildв классеAccessibleContext - Параметры:
-
i- нулевой индекс дочернего элемента - Возвращает:
- n-й дочерний элемент объекта
- См. также:
getLocale
public Locale getLocale()
Возвращает локаль этого объекта.
- Определяется в:
-
getLocaleв классеAccessibleContext - Возвращает:
- локаль этого объекта
getAccessibleComponent
public AccessibleComponent getAccessibleComponent()
Получает
AccessibleComponent , связанный с этим объектом, если он существует. В противном случае вернуть null.- Overrides:
-
getAccessibleComponentв классеAccessibleContext - Возвращает:
- компонент
- См. также:
getBackground
public Color getBackground()
Получает цвет фона этого объекта.
- Определяется в:
-
getBackgroundв интерфейсеAccessibleComponent - Возвращает:
- цвет фона объекта, если поддерживается; в противном случае,
null - См. также:
setBackground
public void setBackground(Color c)
Устанавливает цвет фона этого объекта. (Для прозрачности см.
isOpaque.)- Определяется в:
-
setBackgroundв интерфейсеAccessibleComponent - Параметры:
-
c- новыйColorдля фона - См. также:
getForeground
public Color getForeground()
Получает цвет переднего плана этого объекта.
- Определяется в:
-
getForegroundв интерфейсеAccessibleComponent - Возвращает:
- цвет переднего плана объекта, если поддерживается; в противном случае,
null - См. также:
setForeground
public void setForeground(Color c)
Устанавливает цвет переднего плана этого объекта.
- Определено в:
-
setForegroundв интерфейсеAccessibleComponent - Параметры:
-
c- новый цвет переднего плана - См. также:
getCursor
public Cursor getCursor()
Возвращает курсор этого объекта.
- Определено в:
-
getCursorв интерфейсеAccessibleComponent - Возвращает:
- курсор объекта, если поддерживается; иначе,
null - См. также:
setCursor
public void setCursor(Cursor cursor)
Устанавливает курсор этого объекта.
Метод может не иметь визуального эффекта, если реализация Java платформы и/или системная нативная среда не поддерживают изменение формы курсора мыши.
- Определено в:
-
setCursorв интерфейсеAccessibleComponent - Параметры:
-
cursor- новый курсор объекта - См. также:
getFont
public Font getFont()
Возвращает шрифт этого объекта.
- Определено в:
-
getFontв интерфейсеAccessibleComponent - Возвращает:
- шрифт объекта, если поддерживается; иначе,
null - См. также:
setFont
public void setFont(Font f)
Устанавливает шрифт этого объекта.
- Определено в:
-
setFontв интерфейсеAccessibleComponent - Параметры:
-
f- новый шрифт объекта - См. также:
getFontMetrics
public FontMetrics getFontMetrics(Font f)
Возвращает метрику шрифта этого объекта.
- Определено в:
-
getFontMetricsв интерфейсеAccessibleComponent - Параметры:
-
f- шрифт - Возвращает:
- метрику шрифта, если поддерживается; иначе,
null - См. также:
isEnabled
public boolean isEnabled()
Определяет, является ли объект активным.
- Определено в:
-
isEnabledв интерфейсеAccessibleComponent - Возвращает:
- true, если объект активен; иначе, false
- См. также:
setEnabled
public void setEnabled(boolean b)
Устанавливает состояние активности объекта.
- Определено в:
-
setEnabledв интерфейсеAccessibleComponent - Параметры:
-
b- true, чтобы активировать объект; иначе, деактивировать - См. также:
isVisible
public boolean isVisible()
Определяет, виден ли объект. Примечание: это означает, что объект намерен быть видимым; однако, он может на самом деле не отображаться на экране, потому что один из объектов, содержащий этот объект, не виден. Чтобы определить, отображается ли объект на экране, используйте
isShowing.- Определено в:
-
isVisibleв интерфейсеAccessibleComponent - Возвращает:
- true, если объект виден; иначе, false
- См. также:
setVisible
public void setVisible(boolean b)
Устанавливает состояние видимости объекта.
- Определено в:
-
setVisibleв интерфейсеAccessibleComponent - Параметры:
-
b- true, чтобы показать объект; иначе, скрыть - См. также:
isShowing
public boolean isShowing()
Определяет, отображается ли объект. Это определяется проверкой видимости объекта и предков объекта. Примечание: это вернёт true, даже если объект скрыт другим (например, он находится под выпадающим меню).
- Определено в:
-
isShowingв интерфейсеAccessibleComponent - Возвращает:
- true, если объект отображается; иначе, false
contains
public boolean contains(Point p)
Проверяет, находится ли указанная точка внутри границ этого объекта, где координаты x и y точки определены относительно системы координат объекта.
- Определено в:
-
containsв интерфейсеAccessibleComponent - Параметры:
-
p- точка относительно системы координат объекта - Возвращает:
- true, если объект содержит точку; иначе false
- См. также:
getLocationOnScreen
public Point getLocationOnScreen()
Возвращает расположение объекта на экране.
- Определено в:
-
getLocationOnScreenв интерфейсеAccessibleComponent - Возвращает:
- расположение объекта на экране — может быть
null, если этот объект не находится на экране - См. также:
getLocation
public Point getLocation()
Возвращает расположение объекта относительно родителя в виде точки, определяющей верхний левый угол объекта в пространстве координат экрана.
- Определено в:
-
getLocationв интерфейсеAccessibleComponent - Возвращает:
- экземпляр Point, представляющий верхний левый угол границ объекта в пространстве координат экрана;
null, если этот объект или его родитель не находятся на экране - См. также:
setLocation
public void setLocation(Point p)
Устанавливает расположение объекта относительно родителя.
- Определено в:
-
setLocationв интерфейсеAccessibleComponent - Параметры:
-
p- координаты объекта - См. также:
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, 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