Интерфейс InputMethodRequests

Rectangle getTextLocation(TextHitInfo offset)

Получает расположение указанного смещения в текущем составленном тексте или выделения в подтверждённом тексте. Эта информация используется, например, для размещения окна кандидатов рядом с составленным текстом или окна композиции рядом с местом вставки подтверждённого текста.

Если компонент содержит составленный текст (потому что в него был отправлен последний InputMethodEvent, содержащий составленный текст), то смещение относится к составленному тексту — смещение 0 указывает на первый символ в составленном тексте. Возвращаемое расположение должно быть для этого символа.

Если компонент не содержит составленного текста, смещение должно быть проигнорировано, и возвращаемое расположение должно отражать начало (в направлении строки) выделения в последней строке, содержащей выделенный текст. Например, для горизонтального текста слева направо (например, английский) возвращается расположение слева от самого левого символа в последней строке, содержащей выделенный текст. Для вертикального текста сверху вниз, с линиями, идущими справа налево, возвращается расположение над самой левой линией, содержащей выделенный текст.

Расположение представлено как маркер с толщиной 0, то есть он имеет ширину 0, если текст отображается горизонтально, и высоту 0, если текст отображается вертикально. Другие ориентации текста должны быть отображены в горизонтальной или вертикальной ориентации. Прямоугольник использует абсолютные координаты экрана.

TextHitInfo getLocationOffset(int x, int y)

Получает смещение в составленном тексте для указанных абсолютных координат x и y на экране. Эта информация используется, например, для обработки щелчков мышью и курсора мыши. Смещение относится к составленному тексту, поэтому смещение 0 указывает на начало составленного текста.

Вернуть null, если расположение находится за пределами области, занимаемой составленным текстом.

int getInsertPositionOffset()

Получает смещение позиции вставки в подтверждённый текст, содержащийся в компоненте редактирования текста. Это смещение, в котором вставляются символы, вводимые через метод ввода. Эта информация используется методом ввода, например, для анализа текста, окружающего позицию вставки.

AttributedCharacterIterator getCommittedText(int beginIndex, int endIndex, AttributedCharacterIterator.Attribute[] attributes)

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

Метод ввода может предоставить список атрибутов, которые его интересуют. В этом случае информация об атрибутах, которые может потребоваться реализатору, не должна быть доступна через итератор. Если список равен null, вся доступная информация об атрибутах должна быть доступна.

int getCommittedTextLength()

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

AttributedCharacterIterator cancelLatestCommittedText(AttributedCharacterIterator.Attribute[] attributes)

Получает последний подтверждённый текст из компонента редактирования текста и удаляет его из тела текста компонента. Это используется для функции «Отмена подтверждения» в некоторых методах ввода, где подтверждённый текст возвращается в его предыдущее составленное состояние. Составленный текст будет отправлен компоненту с помощью InputMethodEvent.

В целом, эта функция должна поддерживаться только сразу после подтверждения текста, а не после выполнения пользователем других операций над текстом. Когда функция не поддерживается, возвращается null.

Метод ввода может предоставить список атрибутов, которые его интересуют. В этом случае информация об атрибутах, которые может потребоваться реализатору, не должна быть доступна через итератор. Если список равен null, вся доступная информация об атрибутах должна быть доступна.

AttributedCharacterIterator getSelectedText(AttributedCharacterIterator.Attribute[] attributes)

Получает текущий выделенный текст из компонента редактирования текста. Это может использоваться для различных целей. Одна из них — функция «Преобразовать снова» в некоторых методах ввода. В этом случае метод ввода обычно отправляет событие метода ввода для замены выделенного текста составленным текстом. В зависимости от возможностей метода ввода, это может быть исходный составленный текст для выделенного текста, последний составленный текст, введённый где-либо в тексте, или версия текста, преобразованная обратно из выделенного текста.

Метод ввода может предоставить список атрибутов, которые его интересуют. В этом случае информация об атрибутах, которые может потребоваться реализатору, не должна быть доступна через итератор. Если список равен null, вся доступная информация об атрибутах должна быть доступна.