java.awt.im

Интерфейсный InputMethodRequests

Все Известные Подынтерфейсы:

InputMethodContext

public interface InputMethodRequests

InputMethodRequests определяет запросы, которые должен обработать компонент редактирования текста, чтобы работать с входными методами. Компонент может реализовать этот интерфейс непосредственно или использовать отдельный объект, который реализует это. Объект, реализовывая этот интерфейс должен быть возвращен из getInputMethodRequests метода компонента.

Компонент редактирования текста также должен предоставить входному слушателю события метода.

Интерфейс разрабатывается, чтобы поддерживать один из двух входных пользовательских интерфейсов:

• ввод на месте, где составленный текст выводится на экран как часть текстового компонентного текстового тела.
• ниже пятна ввод, где составленный текст выводится на экран в отдельном окне состава только ниже точки вставки, где текст будет вставлен, когда это будет фиксироваться. Отметьте, что, если текст выбирается в пределах текстового тела компонента, этот текст будет заменен фиксировавшим текстом об обязательстве; поэтому это не считают частью контекста, в который вводится текст.

С тех пор:

1.2

См. Также:

Component.getInputMethodRequests(), InputMethodListener

Сводка метода

Методы

Модификатор и Тип	Метод и Описание
AttributedCharacterIterator	cancelLatestCommittedText(AttributedCharacterIterator.Attribute[] attributes) Получает последний фиксировавший текст от компонента редактирования текста и удаляет это из текстового тела компонента.
AttributedCharacterIterator	getCommittedText(int beginIndex, int endIndex, AttributedCharacterIterator.Attribute[] attributes) Получает iterator обеспечение доступа ко всему тексту и приписывает содержавшийся в компоненте редактирования текста за исключением незафиксированного текста.
int	getCommittedTextLength() Получает длину всего текста, содержавшегося в компоненте редактирования текста за исключением незафиксированного (составленного) текста.
int	getInsertPositionOffset() Получает смещение позиции вставки в фиксировавшем тексте, содержавшемся в компоненте редактирования текста.
TextHitInfo	getLocationOffset(int x, int y) Получает смещение в пределах составленного текста для указанного абсолютного x и координат y на экране.
AttributedCharacterIterator	getSelectedText(AttributedCharacterIterator.Attribute[] attributes) Получает в настоящий момент выбранный текст от компонента редактирования текста.
Прямоугольник	getTextLocation(TextHitInfo offset) Получает расположение указанного смещения в токе составленный текст, или выбора в фиксировавшем тексте.

Деталь метода

getTextLocation

Rectangle getTextLocation(TextHitInfo offset)

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

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

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

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

Параметры:

offset - смещение в пределах составленного текста, если есть составленный текст; нуль иначе

Возвраты:

прямоугольник, представляющий расположение на экране смещения

getLocationOffset

TextHitInfo getLocationOffset(int x,
                            int y)

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

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

Параметры:

x - абсолютные x координируют на экране

y - абсолютные y координируют на экране

Возвраты:

текстовая информация хита, описывающая смещение в составленном тексте.

getInsertPositionOffset

int getInsertPositionOffset()

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

Возвраты:

смещение позиции вставки

getCommittedText

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

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

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

Параметры:

beginIndex - индекс первого символа

endIndex - индекс символа после последнего знака

attributes - список атрибутов, которыми интересуется входной метод

Возвраты:

iterator обеспечение доступа к тексту и его атрибутам

getCommittedTextLength

int getCommittedTextLength()

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

Возвраты:

длина текста за исключением незафиксированного текста

cancelLatestCommittedText

AttributedCharacterIterator cancelLatestCommittedText(AttributedCharacterIterator.Attribute[] attributes)

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

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

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

Параметры:

attributes - список атрибутов, которыми интересуется входной метод

Возвраты:

последний фиксировавший текст, или нуль, когда "функция" Фиксации Отмены не поддерживается

getSelectedText

AttributedCharacterIterator getSelectedText(AttributedCharacterIterator.Attribute[] attributes)

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

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

Параметры:

attributes - список атрибутов, которыми интересуется входной метод

Возвраты:

в настоящий момент выбранный текст