java.awt.im

Class InputMethodHighlight

java.lang.Object

java.awt.im.InputMethodHighlight

public class InputMethodHighlight
extends Object

InputMethodHighlight用于描述正在组成的文本的突出显示属性。 描述可以分为两个层次：在抽象级别，它指定转换状态以及文本是否被选择; 在具体级别，它指定用于渲染突出显示的样式属性。 InputMethodHighlight必须在抽象级别提供描述; 它可能或可能不提供具体级别的描述。 如果没有提供具体的样式，则渲染器应使用Toolkit.mapInputMethodHighlight(java.awt.im.InputMethodHighlight)映射到具体样式。

抽象描述由三个字段组成： selected ， state和variation 。 selected指示文本范围是输入法当前正在工作的范围，例如，当前在菜单中显示转换候选的段。 state表示转换状态。 状态值由输入法框架定义，并应在从抽象到具体样式的所有映射中进行区分。 当前定义的状态值为raw（未转换）并转换。 这些状态值建议在文本构成的主要转换步骤之前和之后使用，例如，在kana-> kanji或pinyin-> hanzi转换之前和之后。 variation字段允许输入法表达关于转换结果的附加信息。

InputMethodHighlight实例通常用作从AttributeCharacterIterator为INPUT_METHOD_HIGHLIGHT属性返回的属性值。 它们可能被包装到Annotation实例中以指示单独的文本段。

从以下版本开始：

1.2

另请参见：

AttributedCharacterIterator

Field Summary

Fields

Modifier and Type	Field and Description
static int	CONVERTED_TEXT 转换文本状态的常数。
static int	RAW_TEXT 原始文本状态不变。
static InputMethodHighlight	SELECTED_CONVERTED_TEXT_HIGHLIGHT 所选转换文本的默认高亮度的常数。
static InputMethodHighlight	SELECTED_RAW_TEXT_HIGHLIGHT 所选原始文本的默认突出显示的常数。
static InputMethodHighlight	UNSELECTED_CONVERTED_TEXT_HIGHLIGHT 未选择转换文本的默认高亮的常数。
static InputMethodHighlight	UNSELECTED_RAW_TEXT_HIGHLIGHT 未选择的原始文本的默认突出显示的常数。

构造方法摘要

构造方法

Constructor and Description
InputMethodHighlight(boolean selected, int state) 构造输入法高亮记录。
InputMethodHighlight(boolean selected, int state, int variation) 构造输入法高亮记录。
InputMethodHighlight(boolean selected, int state, int variation, Map<TextAttribute,?> style) 构造输入法高亮记录。

方法摘要

Modifier and Type	Method and Description
int	getState() 返回文本范围的转换状态。
Map<TextAttribute,?>	getStyle() 返回文本范围的渲染样式属性，或返回null。
int	getVariation() 返回文本范围的变化。
boolean	isSelected() 返回是否选择文本范围。

Methods inherited from class java.lang.Object

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

字段详细信息

RAW_TEXT

public static final int RAW_TEXT

原始文本状态不变。

另请参见：

Constant Field Values

CONVERTED_TEXT

public static final int CONVERTED_TEXT

转换文本状态的常数。

另请参见：

Constant Field Values

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之外的状态

另请参见：

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之外的状态

另请参见：

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

另请参见：

RAW_TEXT ， CONVERTED_TEXT

方法详细信息

isSelected

public boolean isSelected()

返回是否选择文本范围。

getState

public int getState()

返回文本范围的转换状态。

结果

文本范围的转换状态 - RAW_TEXT或CONVERTED_TEXT。

另请参见：

RAW_TEXT ， CONVERTED_TEXT

getVariation

public int getVariation()

返回文本范围的变化。

getStyle

public Map<TextAttribute,?> getStyle()

返回文本范围的渲染样式属性，或返回null。

从以下版本开始：

1.3