Класс InputMethodHighlight

java.lang.Object

java.awt.im.InputMethodHighlight

public class InputMethodHighlight extends Object

InputMethodHighlight используется для описания атрибутов выделения составляемого текста. Описание может быть задано на двух уровнях: на абстрактном уровне оно указывает состояние преобразования и то, выбран ли текст; на конкретном уровне оно задаёт атрибуты стиля, используемые для отображения выделения. InputMethodHighlight должен предоставлять описание на абстрактном уровне; описание на конкретном уровне может предоставляться или не предоставляться. Если конкретный стиль не задан, средство отображения должно использовать Toolkit.mapInputMethodHighlight(InputMethodHighlight) для сопоставления с конкретным стилем.

Абстрактное описание состоит из трёх полей: selected, state и variation. selected указывает, является ли диапазон текста тем, с которым в данный момент работает метод ввода, например сегментом, для которого в меню в данный момент отображаются варианты преобразования. state представляет состояние преобразования. Значения состояния задаются платформой методов ввода и должны различаться во всех сопоставлениях абстрактных стилей с конкретными. В настоящее время определены значения состояния raw (не преобразованный) и converted (преобразованный). Эти значения состояния рекомендуется использовать до и после основного этапа преобразования при составлении текста, например до и после преобразования kana->kanji или pinyin->hanzi. Поле variation позволяет методам ввода предоставлять дополнительную информацию о результатах преобразования.

Экземпляры InputMethodHighlight обычно используются как значения атрибутов, возвращаемые AttributedCharacterIterator для атрибута INPUT_METHOD_HIGHLIGHT. Они могут быть обёрнуты в экземпляры Annotation, чтобы обозначить отдельные текстовые сегменты.

Начиная с:

1.2

См. также:

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

Модификатор и тип	Поле	Описание
`static final int`	`CONVERTED_TEXT`	Константа для состояния преобразованного текста.
`static final int`	`RAW_TEXT`	Константа для состояния исходного текста.
`static final InputMethodHighlight`	`SELECTED_CONVERTED_TEXT_HIGHLIGHT`	Константа для выделения по умолчанию выбранного преобразованного текста.
`static final InputMethodHighlight`	`SELECTED_RAW_TEXT_HIGHLIGHT`	Константа для выделения по умолчанию выбранного исходного текста.
`static final InputMethodHighlight`	`UNSELECTED_CONVERTED_TEXT_HIGHLIGHT`	Константа для выделения по умолчанию невыбранного преобразованного текста.
`static final InputMethodHighlight`	`UNSELECTED_RAW_TEXT_HIGHLIGHT`	Константа для выделения по умолчанию невыбранного исходного текста.

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

Конструктор	Описание
`InputMethodHighlight(boolean selected, int state)`	Создаёт запись выделения метода ввода.
`InputMethodHighlight(boolean selected, int state, int variation)`	Создаёт запись выделения метода ввода.
`InputMethodHighlight(boolean selected, int state, int variation, Map<TextAttribute, ?> style)`	Создаёт запись выделения метода ввода.

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

Модификатор и тип	Метод	Описание
`int`	`getState()`	Возвращает состояние преобразования диапазона текста.
`Map<TextAttribute, ?>`	`getStyle()`	Возвращает атрибуты стиля отображения диапазона текста или null.
`int`	`getVariation()`	Возвращает вариацию диапазона текста.
`boolean`	`isSelected()`	Возвращает, выбран ли диапазон текста.

Методы, объявленные в классе Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

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

RAW_TEXT

public static final int RAW_TEXT

Константа для состояния исходного текста.

См. также:

CONVERTED_TEXT

public static final int CONVERTED_TEXT

Константа для состояния преобразованного текста.

См. также:

UNSELECTED_RAW_TEXT_HIGHLIGHT

public static final InputMethodHighlight UNSELECTED_RAW_TEXT_HIGHLIGHT

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

SELECTED_RAW_TEXT_HIGHLIGHT

public static final InputMethodHighlight SELECTED_RAW_TEXT_HIGHLIGHT

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

UNSELECTED_CONVERTED_TEXT_HIGHLIGHT

public static final InputMethodHighlight UNSELECTED_CONVERTED_TEXT_HIGHLIGHT

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

SELECTED_CONVERTED_TEXT_HIGHLIGHT

public static final InputMethodHighlight SELECTED_CONVERTED_TEXT_HIGHLIGHT

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

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

InputMethodHighlight

public InputMethodHighlight(boolean selected, int state)

Создаёт запись выделения метода ввода. Для вариации задаётся значение 0, для стиля — null.

Параметры:

selected — выбран ли диапазон текста

state — состояние преобразования диапазона текста: RAW_TEXT или CONVERTED_TEXT

Исключения:

IllegalArgumentException — если задано состояние, отличное от RAW_TEXT или CONVERTED_TEXT

См. также:

InputMethodHighlight

public InputMethodHighlight(boolean selected, int state, int variation)

Создаёт запись выделения метода ввода. Для стиля задаётся значение null.

Параметры:

selected — выбран ли диапазон текста

state — состояние преобразования диапазона текста: RAW_TEXT или CONVERTED_TEXT

variation — вариация стиля для диапазона текста

Исключения:

IllegalArgumentException — если задано состояние, отличное от RAW_TEXT или CONVERTED_TEXT

См. также:

InputMethodHighlight

public InputMethodHighlight(boolean selected, int state, int variation, Map<TextAttribute, ?> style)

Создаёт запись выделения метода ввода. Предоставленная карта атрибутов стиля должна быть неизменяемой.

Параметры:

selected — выбран ли диапазон текста

state — состояние преобразования диапазона текста: RAW_TEXT или CONVERTED_TEXT

variation — вариация диапазона текста

style — атрибуты стиля отображения диапазона текста или null

Исключения:

IllegalArgumentException — если задано состояние, отличное от RAW_TEXT или CONVERTED_TEXT

Начиная с:

1.3

См. также:

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

isSelected

public boolean isSelected()

Возвращает, выбран ли диапазон текста.

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

getState

public int getState()

Возвращает состояние преобразования диапазона текста.

Возвращает:

Состояние преобразования диапазона текста: RAW_TEXT или CONVERTED_TEXT.

См. также:

getVariation

public int getVariation()

Возвращает вариацию диапазона текста.

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

getStyle

public Map<TextAttribute, ?> getStyle()

Возвращает атрибуты стиля отображения диапазона текста или null.

Возвращает:: атрибуты стиля отображения диапазона текста или null
Начиная с:: 1.3

© 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://docs.oracle.com/en/java/javase/25/docs/api/java.desktop/java/awt/im/InputMethodHighlight.html