Интерфейс AccessibleText

Все известные подинтерфейсы:: AccessibleEditableText, AccessibleHypertext

Все известные реализующие классы:: AbstractButton.AccessibleAbstractButton, JButton.AccessibleJButton, JCheckBox.AccessibleJCheckBox, JCheckBoxMenuItem.AccessibleJCheckBoxMenuItem, JEditorPane.AccessibleJEditorPane, JEditorPane.AccessibleJEditorPaneHTML, JEditorPane.JEditorPaneAccessibleHypertextSupport, JLabel.AccessibleJLabel, JMenu.AccessibleJMenu, JMenuItem.AccessibleJMenuItem, JPasswordField.AccessibleJPasswordField, JRadioButton.AccessibleJRadioButton, JRadioButtonMenuItem.AccessibleJRadioButtonMenuItem, JSpinner.AccessibleJSpinner, JTextArea.AccessibleJTextArea, JTextComponent.AccessibleJTextComponent, JTextField.AccessibleJTextField, JToggleButton.AccessibleJToggleButton, ProgressMonitor.AccessibleProgressMonitor, TextArea.AccessibleAWTTextArea, TextComponent.AccessibleAWTTextComponent, TextField.AccessibleAWTTextField

public interface AccessibleText

Интерфейс AccessibleText должен быть реализован всеми классами, которые представляют текстовую информацию на экране. Этот интерфейс предоставляет стандартный механизм для использования технологии вспомогательных средств для доступа к этому тексту через его содержимое, атрибуты и пространственное расположение. Приложения могут определить, поддерживает ли объект интерфейс AccessibleText, сначала получив его AccessibleContext (см. Accessible) и затем вызвав метод AccessibleContext.getAccessibleText() объекта AccessibleContext. Если возвращаемое значение не null, объект поддерживает этот интерфейс.

См. также:

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

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

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

Модификатор и тип	Метод	Описание
`String`	`getAfterIndex(int part, int index)`	Возвращает `String` после заданного индекса.
`String`	`getAtIndex(int part, int index)`	Возвращает `String` по заданному индексу.
`String`	`getBeforeIndex(int part, int index)`	Возвращает `String` перед заданным индексом.
`int`	`getCaretPosition()`	Возвращает смещение курсора, отсчитываемое от нуля.
`AttributeSet`	`getCharacterAttribute(int i)`	Возвращает `AttributeSet` для заданного символа по заданному индексу.
`Rectangle`	`getCharacterBounds(int i)`	Определяет область (bounding box) символа по заданному индексу в строке.
`int`	`getCharCount()`	Возвращает количество символов (валидных индексов).
`int`	`getIndexAtPoint(Point p)`	По заданной точке в локальных координатах возвращает индекс (от нуля) символа под этой точкой.
`String`	`getSelectedText()`	Возвращает выделенную часть текста.
`int`	`getSelectionEnd()`	Возвращает конечное смещение внутри выделенного текста.
`int`	`getSelectionStart()`	Возвращает начальное смещение внутри выделенного текста.

Подробное описание полей

CHARACTER

static final int CHARACTER

Константа, используемая для указания того, что часть текста, которая должна быть извлечена, является символом.

См. также:

WORD

static final int WORD

Константа, используемая для указания того, что часть текста, которая должна быть извлечена, является словом.

См. также:

SENTENCE

static final int SENTENCE

Константа, используемая для указания того, что часть текста, которая должна быть извлечена, является предложением.

Предложение — это ряд слов, которые выражают утверждение, вопрос, команду, желание, восклицание или выполнение действия. В английских локализациях строка обычно начинается с заглавной буквы и заканчивается соответствующей конечной пунктуацией; например, точка, вопросительный или восклицательный знак. В других локалях могут использоваться другие регистры и/или пунктуация.

См. также:

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

getIndexAtPoint

int getIndexAtPoint(Point p)

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

Параметры:: p - точка в локальных координатах
Возвращает:: нулевой индекс символа под Point p; если точка недействительна, возвращает -1.

getCharacterBounds

Rectangle getCharacterBounds(int i)

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

Параметры:: i - индекс в строке
Возвращает:: экранные координаты прямоугольника, ограничивающего символ; если индекс недействителен, возвращается пустой прямоугольник.

getCharCount

int getCharCount()

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

Возвращает:: количество символов

getCaretPosition

int getCaretPosition()

Возвращает смещение курсора с нулевым значением.

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

Возвращает:: смещение курсора с нулевым значением

getAtIndex

String getAtIndex(int part, int index)

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

Параметры:: part - CHARACTER, WORD или SENTENCE для извлечения; index - индекс в тексте
Возвращает:: символ, слово или предложение

getAfterIndex

String getAfterIndex(int part, int index)

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

Параметры:: part - CHARACTER, WORD или SENTENCE для извлечения; index - индекс в тексте
Возвращает:: символ, слово или предложение

getBeforeIndex

String getBeforeIndex(int part, int index)

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

Параметры:: part - CHARACTER, WORD или SENTENCE для извлечения; index - индекс в тексте
Возвращает:: символ, слово или предложение

getCharacterAttribute

AttributeSet getCharacterAttribute(int i)

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

Параметры:: i - нулевой индекс в тексте
Возвращает:: AttributeSet символа

getSelectionStart

int getSelectionStart()

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

Возвращает:: индекс в тексте начала выделения

getSelectionEnd

int getSelectionEnd()

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

Возвращает:: индекс в тексте конца выделения

getSelectedText

String getSelectedText()

Возвращает часть текста, которая выбрана.

Возвращает:: выбранную часть текста

© 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.
https://download.java.net/java/early_access/jdk24/docs/api/java.desktop/javax/accessibility/AccessibleText.html