Класс TextComponent.AccessibleAWTTextComponent

java.awt.TextComponent.AccessibleAWTTextComponent

Все реализованные интерфейсы:: TextListener, Serializable, EventListener, AccessibleComponent, AccessibleText

Прямые известные подклассы:: TextArea.AccessibleAWTTextArea, TextField.AccessibleAWTTextField

Внешний класс:: TextComponent

protected class TextComponent.AccessibleAWTTextComponent extends Component.AccessibleAWTComponent implements AccessibleText, TextListener

Этот класс реализует поддержку специальных возможностей для класса TextComponent. Он предоставляет реализацию Java Accessibility API, подходящую для элементов пользовательского интерфейса текстовых компонентов.

Начиная с версии:

1.3

См. также:

Краткое описание вложенных классов

Вложенные классы/интерфейсы, объявленные в классе Component.AccessibleAWTComponent

Component.AccessibleAWTComponent.AccessibleAWTComponentHandler, Component.AccessibleAWTComponent.AccessibleAWTFocusHandler

Модификатор и тип	Класс	Описание
`protected class`	`Component.AccessibleAWTComponent.AccessibleAWTComponentHandler`	Уведомляет слушателя PropertyChange, если он зарегистрирован, при отображении/скрытии.
`protected class`	`Component.AccessibleAWTComponent.AccessibleAWTFocusHandler`	Уведомляет слушателя PropertyChange, если он зарегистрирован, при возникновении событий фокуса.

Краткое описание полей

Поля, объявленные в классе Component.AccessibleAWTComponent

accessibleAWTComponentHandler, accessibleAWTFocusHandler

Модификатор и тип	Поле	Описание
`protected ComponentListener`	`accessibleAWTComponentHandler`	Слушатель компонента для отслеживания событий отображения/скрытия/изменения размера и преобразования их в события PropertyChange.
`protected FocusListener`	`accessibleAWTFocusHandler`	Слушатель для отслеживания событий фокуса и преобразования их в события PropertyChange.

Поля, объявленные в классе 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

Модификатор и тип	Поле	Описание
`static final String`	`ACCESSIBLE_ACTION_PROPERTY`	Константа, используемая для указания на изменение поддерживаемого набора действий.
`static final String`	`ACCESSIBLE_ACTIVE_DESCENDANT_PROPERTY`	Константа, используемая для определения изменения активного потомка компонента.
`static final String`	`ACCESSIBLE_CARET_PROPERTY`	Константа, используемая для определения изменения каретки `accessibleText`.
`static final String`	`ACCESSIBLE_CHILD_PROPERTY`	Константа, используемая для определения добавления/удаления дочерних элементов `Accessible` у объекта.
`static final String`	`ACCESSIBLE_COMPONENT_BOUNDS_CHANGED`	`PropertyChangeEvent`, указывающая на изменение границ компонента.
`static final String`	`ACCESSIBLE_DESCRIPTION_PROPERTY`	Константа, используемая для определения изменения свойства `AccessibleContext.accessibleDescription`.
`static final String`	`ACCESSIBLE_HYPERTEXT_OFFSET`	Константа, используемая для указания на получение фокуса гипертекстовым элементом.
`static final String`	`ACCESSIBLE_INVALIDATE_CHILDREN`	`PropertyChangeEvent`, указывающая на существенное изменение дочерних элементов компонента, например дерева или текста.
`static final String`	`ACCESSIBLE_NAME_PROPERTY`	Константа, используемая для определения изменения свойства `AccessibleContext.accessibleName`.
`static final String`	`ACCESSIBLE_SELECTION_PROPERTY`	Константа, используемая для определения изменения `accessibleSelection`.
`static final String`	`ACCESSIBLE_STATE_PROPERTY`	Константа, используемая для определения изменения свойства `accessibleStateSet`.
`static final String`	`ACCESSIBLE_TABLE_CAPTION_CHANGED`	Константа, используемая для указания на изменение заголовка таблицы.
`static final String`	`ACCESSIBLE_TABLE_COLUMN_DESCRIPTION_CHANGED`	Константа, используемая для указания на изменение описания столбца.
`static final String`	`ACCESSIBLE_TABLE_COLUMN_HEADER_CHANGED`	Константа, используемая для указания на изменение заголовка столбца.
`static final String`	`ACCESSIBLE_TABLE_MODEL_CHANGED`	Константа, используемая для указания на изменение данных таблицы.
`static final String`	`ACCESSIBLE_TABLE_ROW_DESCRIPTION_CHANGED`	Константа, используемая для указания на изменение описания строки.
`static final String`	`ACCESSIBLE_TABLE_ROW_HEADER_CHANGED`	Константа, используемая для указания на изменение заголовка строки.
`static final String`	`ACCESSIBLE_TABLE_SUMMARY_CHANGED`	Константа, используемая для указания на изменение сводки таблицы.
`static final String`	`ACCESSIBLE_TEXT_ATTRIBUTES_CHANGED`	`PropertyChangeEvent`, указывающая на изменение текстовых атрибутов.
`static final String`	`ACCESSIBLE_TEXT_PROPERTY`	`PropertyChangeEvent`, указывающая на изменение текста.
`static final String`	`ACCESSIBLE_VALUE_PROPERTY`	Константа, используемая для определения изменения свойства `accessibleValue`.
`static final String`	`ACCESSIBLE_VISIBLE_DATA_PROPERTY`	Константа, используемая для определения изменения визуального представления объекта.
`protected String`	`accessibleDescription`	Локализованная строка с описанием объекта.
`protected String`	`accessibleName`	Локализованная строка с именем объекта.
`protected Accessible`	`accessibleParent`	Родительский объект с поддержкой специальных возможностей для этого объекта.

Поля, объявленные в интерфейсе AccessibleText

CHARACTER, SENTENCE, WORD

Модификатор и тип	Поле	Описание
`static final int`	`CHARACTER`	Константа, используемая для указания, что извлекаемая часть текста является символом.
`static final int`	`SENTENCE`	Константа, используемая для указания, что извлекаемая часть текста является предложением.
`static final int`	`WORD`	Константа, используемая для указания, что извлекаемая часть текста является словом.

Краткое описание конструкторов

Конструктор	Описание
`AccessibleAWTTextComponent()`	Создает AccessibleAWTTextComponent.

Краткое описание методов

Модификатор и тип	Метод	Описание
`AccessibleRole`	`getAccessibleRole()`	Возвращает роль этого объекта.
`AccessibleStateSet`	`getAccessibleStateSet()`	Возвращает набор состояний TextComponent.
`AccessibleText`	`getAccessibleText()`	Возвращает AccessibleText, связанный с этим объектом.
`String`	`getAfterIndex(int part, int index)`	Возвращает строку после указанного индекса.
`String`	`getAtIndex(int part, int index)`	Возвращает строку по указанному индексу.
`String`	`getBeforeIndex(int part, int index)`	Возвращает строку перед указанным индексом.
`int`	`getCaretPosition()`	Возвращает смещение каретки, отсчитываемое от нуля.
`AttributeSet`	`getCharacterAttribute(int i)`	Возвращает AttributeSet для указанного символа (по указанному индексу).
`Rectangle`	`getCharacterBounds(int i)`	Определяет ограничивающий прямоугольник символа по указанному индексу в строке.
`int`	`getCharCount()`	Возвращает количество символов (допустимых индексов).
`int`	`getIndexAtPoint(Point p)`	Для точки в локальных координатах возвращает индекс символа, расположенного под этой точкой; индексация начинается с нуля.
`String`	`getSelectedText()`	Возвращает выделенную часть текста.
`int`	`getSelectionEnd()`	Возвращает конечное смещение в выделенном тексте.
`int`	`getSelectionStart()`	Возвращает начальное смещение в выделенном тексте.
`void`	`textValueChanged(TextEvent textEvent)`	Уведомление TextListener об изменении значения текста.

Методы, объявленные в классе Component.AccessibleAWTComponent

addFocusListener, addPropertyChangeListener, contains, getAccessibleAt, getAccessibleChild, getAccessibleChildrenCount, getAccessibleComponent, getAccessibleDescription, getAccessibleIndexInParent, getAccessibleName, getAccessibleParent, getBackground, getBounds, getCursor, getFont, getFontMetrics, getForeground, getLocale, getLocation, getLocationOnScreen, getSize, isEnabled, isFocusTraversable, isShowing, isVisible, removeFocusListener, removePropertyChangeListener, requestFocus, setBackground, setBounds, setCursor, setEnabled, setFont, setForeground, setLocation, setSize, setVisible

Модификатор и тип	Метод	Описание
`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` этого объекта.
`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)`	Задает состояние видимости объекта.

Методы, объявленные в классе AccessibleContext

firePropertyChange, getAccessibleAction, getAccessibleEditableText, getAccessibleIcon, getAccessibleRelationSet, getAccessibleSelection, getAccessibleTable, getAccessibleValue, setAccessibleDescription, setAccessibleName, setAccessibleParent

Модификатор и тип	Метод	Описание
`void`	`firePropertyChange(String propertyName, Object oldValue, Object newValue)`	Поддержка уведомления об изменениях связанных свойств.
`AccessibleAction`	`getAccessibleAction()`	Возвращает `AccessibleAction`, связанный с этим объектом и поддерживающий одно или несколько действий.
`AccessibleEditableText`	`getAccessibleEditableText()`	Возвращает `AccessibleEditableText`, связанный с этим объектом, который отображает редактируемый текст.
`AccessibleIcon[]`	`getAccessibleIcon()`	Возвращает `AccessibleIcons`, связанный с объектом, у которого есть один или несколько связанных значков.
`AccessibleRelationSet`	`getAccessibleRelationSet()`	Возвращает `AccessibleRelationSet`, связанный с объектом.
`AccessibleSelection`	`getAccessibleSelection()`	Возвращает `AccessibleSelection`, связанный с этим объектом и позволяющий выбирать его дочерние элементы `Accessible`.
`AccessibleTable`	`getAccessibleTable()`	Возвращает `AccessibleTable`, связанный с объектом.
`AccessibleValue`	`getAccessibleValue()`	Возвращает `AccessibleValue`, связанный с этим объектом и поддерживающий значение `Numerical`.
`void`	`setAccessibleDescription(String s)`	Задает описание этого объекта для специальных возможностей.
`void`	`setAccessibleName(String s)`	Задает локализованное имя этого объекта для специальных возможностей.
`void`	`setAccessibleParent(Accessible a)`	Задает родительский элемент `Accessible` этого объекта.

Методы, объявленные в классе Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создает и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Указывает, равен ли этот объект какому-либо другому объекту.
`protected void`	`finalize()`	Устарело, подлежит удалению: этот элемент API может быть удален в будущей версии. Финализация устарела и подлежит удалению в одном из будущих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`String`	`toString()`	Возвращает строковое представление объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать пробуждения, обычно вследствие вызова notify или interrupt.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно вследствие вызова notify или interrupt, либо до истечения заданного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно вследствие вызова notify или interrupt, либо до истечения заданного промежутка реального времени.

Подробное описание конструкторов

AccessibleAWTTextComponent

public AccessibleAWTTextComponent()

Создает AccessibleAWTTextComponent. Добавляет слушателя для отслеживания изменения позиции каретки.

Подробное описание методов

textValueChanged

public void textValueChanged(TextEvent textEvent)

Уведомление TextListener об изменении значения текста.

Определен в:: textValueChanged в интерфейсе TextListener
Параметры:: textEvent — событие для обработки

getAccessibleStateSet

public AccessibleStateSet getAccessibleStateSet()

Возвращает набор состояний TextComponent. AccessibleStateSet объекта состоит из набора уникальных AccessibleStates. Изменение AccessibleStateSet объекта приводит к отправке PropertyChangeEvent для свойства AccessibleContext.ACCESSIBLE_STATE_PROPERTY.

Переопределяет:

getAccessibleStateSet в классе Component.AccessibleAWTComponent

Возвращает:

экземпляр AccessibleStateSet, содержащий текущий набор состояний объекта

См. также:

getAccessibleRole

public AccessibleRole getAccessibleRole()

Возвращает роль этого объекта.

Переопределяет:

getAccessibleRole в классе Component.AccessibleAWTComponent

Возвращает:

экземпляр AccessibleRole, описывающий роль объекта (AccessibleRole.TEXT)

См. также:

getAccessibleText

public AccessibleText getAccessibleText()

Возвращает AccessibleText, связанный с этим объектом. В реализации Java Accessibility API для этого класса возвращается сам объект, который реализует интерфейс AccessibleText от своего имени.

Переопределяет:

getAccessibleText в классе AccessibleContext

Возвращает:

этот объект

См. также:

getIndexAtPoint

public int getIndexAtPoint(Point p)

Для точки в локальных координатах возвращает индекс символа под этой точкой, начиная с нуля. Если точка недопустима, метод возвращает -1.

Определен в:: getIndexAtPoint в интерфейсе AccessibleText
Параметры:: p — точка в локальных координатах
Возвращает:: индекс символа под точкой p, начиная с нуля.

getCharacterBounds

public Rectangle getCharacterBounds(int i)

Определяет ограничивающий прямоугольник символа с заданным индексом в строке. Границы возвращаются в локальных координатах. Если индекс недопустим, возвращается пустой прямоугольник.

Определен в:: getCharacterBounds в интерфейсе AccessibleText
Параметры:: i — индекс в String >= 0
Возвращает:: экранные координаты ограничивающего прямоугольника символа

getCharCount

public int getCharCount()

Возвращает количество символов (допустимых индексов)

Определен в:: getCharCount в интерфейсе AccessibleText
Возвращает:: количество символов >= 0

getCaretPosition

public int getCaretPosition()

Возвращает смещение каретки, начиная с нуля. Примечание: символ справа от каретки будет иметь то же значение индекса, что и смещение (каретка находится между двумя символами).

Определен в:: getCaretPosition в интерфейсе AccessibleText
Возвращает:: смещение каретки, начиная с нуля.

getCharacterAttribute

public AttributeSet getCharacterAttribute(int i)

Возвращает AttributeSet для заданного символа (с заданным индексом).

Определен в:: getCharacterAttribute в интерфейсе AccessibleText
Параметры:: i — индекс в тексте, начиная с нуля
Возвращает:: AttributeSet символа

getSelectionStart

public int getSelectionStart()

Возвращает начальное смещение выделенного текста. Если выделения нет, но есть каретка, начальное и конечное смещения совпадают. Возвращает 0, если текст пуст, или позицию каретки, если выделения нет.

Определен в:: getSelectionStart в интерфейсе AccessibleText
Возвращает:: индекс начала выделения в тексте >= 0

getSelectionEnd

public int getSelectionEnd()

Возвращает конечное смещение выделенного текста. Если выделения нет, но есть каретка, начальное и конечное смещения совпадают. Возвращает 0, если текст пуст, или позицию каретки, если выделения нет.

Определен в:: getSelectionEnd в интерфейсе AccessibleText
Возвращает:: индекс конца выделения в тексте >= 0

getSelectedText

public String getSelectedText()

Возвращает выделенную часть текста.

Определен в:: getSelectedText в интерфейсе AccessibleText
Возвращает:: текст или null, если выделения нет

getAtIndex

public String getAtIndex(int part, int index)

Возвращает String по заданному индексу.

Определен в:: getAtIndex в интерфейсе AccessibleText
Параметры:: part — AccessibleText.CHARACTER, AccessibleText.WORD или AccessibleText.SENTENCE для получения; index — индекс в тексте >= 0
Возвращает:: букву, слово или предложение; null для недопустимого индекса или части

getAfterIndex

public String getAfterIndex(int part, int index)

Возвращает String после заданного индекса.

Определен в:: getAfterIndex в интерфейсе AccessibleText
Параметры:: part — AccessibleText.CHARACTER, AccessibleText.WORD или AccessibleText.SENTENCE для получения; index — индекс в тексте >= 0
Возвращает:: букву, слово или предложение; null для недопустимого индекса или части

getBeforeIndex

public String getBeforeIndex(int part, int index)

Возвращает String перед заданным индексом.

Определен в:: getBeforeIndex в интерфейсе AccessibleText
Параметры:: part — AccessibleText.CHARACTER, AccessibleText.WORD или AccessibleText.SENTENCE для получения; index — индекс в тексте >= 0
Возвращает:: букву, слово или предложение; null для недопустимого индекса или части

© 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.