模块 java.desktop
包 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代表转换状态。状态值由输入法框架定义，在从抽象到具体样式的所有map中都应该区分。当前定义的状态值是原始的（未转换的）和已转换的。这些状态值建议在文本组合的主要转换步骤之前和之后使用，例如假名->汉字或拼音->汉字转换之前和之后。 variation 字段允许输入法表达有关转换结果的附加信息。

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

自从：
1.2
参见：

  • 字段详细信息

    • 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)
      构造一个输入方法高亮记录。样式设置为空。
      参数：
      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