Интерфейс InputMethodRequests

Rectangle getTextLocation(TextHitInfo offset)

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

Если компонент содержит составляемый текст (поскольку последнее отправленное ему событие InputMethodEvent содержало составляемый текст), смещение отсчитывается относительно составляемого текста: смещение 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, следует предоставить сведения обо всех доступных атрибутах.