模块  java.desktop
软件包  java.awt.im

Class InputMethodHighlight


  • public class InputMethodHighlight
    extends Object
    InputMethodHighlight用于描述正在撰写的文本的突出显示属性。 描述可以分为两个级别:在抽象级别,它指定转换状态以及是否选择文本; 在具体级别,它指定用于呈现突出显示的样式属性。 InputMethodHighlight必须在抽象级别提供描述; 它可能会也可能不会在具体层面上提供描述。 如果未提供具体样式,则渲染器应使用Toolkit.mapInputMethodHighlight(java.awt.im.InputMethodHighlight)映射到具体样式。

    抽象描述由三个字段组成: selectedstatevariation selected指示文本范围是否是输入方法当前正在处理的范围,例如,当前在菜单中显示转换候选的段。 state表示转换状态。 状态值由输入方法框架定义,并且应在所有映射中区分,从抽象到具体样式。 当前定义的状态值是原始(未转换)和转换。 建议在文本组合的主转换步骤之前和之后使用这些状态值,例如,在假名 - >汉字或拼音 - >汉字转换之前和之后。 variation字段允许输入方法表达有关转换结果的其他信息。

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

    从以下版本开始:
    1.2
    另请参见:
    AttributedCharacterIterator
    • 字段详细信息

      • 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_TEXTCONVERTED_TEXT
      • InputMethodHighlight

        public InputMethodHighlight​(boolean selected,
                                    int state,
                                    int variation)
        构造一个输入法高亮记录。 样式设置为null。
        参数
        selected - 是否选择了文本范围
        state - 文本范围的转换状态 - RAW_TEXT或CONVERTED_TEXT
        variation - 文本范围的样式变体
        异常
        IllegalArgumentException - 如果给出RAW_TEXT或CONVERTED_TEXT以外的状态
        另请参见:
        RAW_TEXTCONVERTED_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_TEXTCONVERTED_TEXT
    • 方法详细信息

      • isSelected

        public boolean isSelected()
        返回是否选择了文本范围。
        结果
        是否选择了文本范围
      • getState

        public int getState()
        返回文本范围的转换状态。
        结果
        文本范围的转换状态 - RAW_TEXT或CONVERTED_TEXT。
        另请参见:
        RAW_TEXTCONVERTED_TEXT
      • getVariation

        public int getVariation()
        返回文本范围的变体。
        结果
        文本范围的变化
      • getStyle

        public Map<TextAttribute,​?> getStyle()
        返回文本范围的呈现样式属性,或null。
        结果
        文本范围的呈现样式属性,或null
        从以下版本开始:
        1.3