java.awt.im
類別 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 表示轉換狀態。狀態值由輸入方法框架定義，並且應該在從抽像樣式到具體樣式的所有映射中明確地表示出來。當前定義的狀態值是原值（未轉換）和已轉換的值。建議在採取撰寫文本的主要轉換步驟前後使用這些狀態值，比方說，在 kana->kanji 或 pinyin->hanzi 轉換前後。variation 欄位允許輸入方法表達有關轉換結果的其他資訊。

InputMethodHighlight 通常用作從用於 INPUT_METHOD_HIGHLIGHT 屬性的 AttributedCharacterIterator 返回的屬性值。可以將它們包裹到 Annotation 實例中，以指示獨立的文本單元。

從以下版本開始：

1.2

另請參見：

AttributedCharacterIterator

欄位摘要

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 未選定原文本的預設高亮顯示常數。

建構子摘要

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() 返回是否已選定文本範圍。

從類別 java.lang.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 之外的狀態

另請參見：

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