Интерфейс 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)`	Определяет ограничивающую рамку символа по заданному индексу в строке.
`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, 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/javax/accessibility/AccessibleText.html