Class InputMethodHighlight

java.lang.Object
java.awt.im.InputMethodHighlight
public class InputMethodHighlight extends Object
An InputMethodHighlight is used to describe the highlight attributes of text being composed. The description can be at two levels: at the abstract level it specifies the conversion state and whether the text is selected; at the concrete level it specifies style attributes used to render the highlight. An InputMethodHighlight must provide the description at the abstract level; it may or may not provide the description at the concrete level. If no concrete style is provided, a renderer should use Toolkit.mapInputMethodHighlight(InputMethodHighlight) to map to a concrete style.

The abstract description consists of three fields: selected, state, and variation. selected indicates whether the text range is the one that the input method is currently working on, for example, the segment for which conversion candidates are currently shown in a menu. state represents the conversion state. State values are defined by the input method framework and should be distinguished in all mappings from abstract to concrete styles. Currently defined state values are raw (unconverted) and converted. These state values are recommended for use before and after the main conversion step of text composition, say, before and after kana->kanji or pinyin->hanzi conversion. The variation field allows input methods to express additional information about the conversion results.

InputMethodHighlight instances are typically used as attribute values returned from AttributedCharacterIterator for the INPUT_METHOD_HIGHLIGHT attribute. They may be wrapped into Annotation instances to indicate separate text segments.

Since:
1.2
See Also:

  • Field Summary

    Fields
    Modifier and Type
    Field
    Description
    static final int
    CONVERTED_TEXT
    Constant for the converted text state.
    static final int
    RAW_TEXT
    Constant for the raw text state.
    static final InputMethodHighlight
    SELECTED_CONVERTED_TEXT_HIGHLIGHT
    Constant for the default highlight for selected converted text.
    static final InputMethodHighlight
    SELECTED_RAW_TEXT_HIGHLIGHT
    Constant for the default highlight for selected raw text.
    static final InputMethodHighlight
    UNSELECTED_CONVERTED_TEXT_HIGHLIGHT
    Constant for the default highlight for unselected converted text.
    static final InputMethodHighlight
    UNSELECTED_RAW_TEXT_HIGHLIGHT
    Constant for the default highlight for unselected raw text.

  • Constructor Summary

    Constructors
    Constructor
    Description
    InputMethodHighlight(boolean selected, int state)
    Constructs an input method highlight record.
    InputMethodHighlight(boolean selected, int state, int variation)
    Constructs an input method highlight record.
    InputMethodHighlight(boolean selected, int state, int variation, Map<TextAttribute, ?> style)
    Constructs an input method highlight record.

  • Method Summary

    Modifier and Type
    Method
    Description
    int
    getState()
    Returns the conversion state of the text range.
    Map<TextAttribute, ?>
    getStyle()
    Returns the rendering style attributes for the text range, or null.
    int
    getVariation()
    Returns the variation of the text range.
    boolean
    isSelected()
    Returns whether the text range is selected.

    Methods inherited from class Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
    Modifier and Type
    Method
    Description
    protected Object
    clone()
    Creates and returns a copy of this object.
    boolean
    equals(Object obj)
    Indicates whether some other object is "equal to" this one.
    protected void
    finalize()
    Deprecated, for removal: This API element is subject to removal in a future version.
    Finalization is deprecated and subject to removal in a future release.
    final Class<?>
    getClass()
    Returns the runtime class of this Object.
    int
    hashCode()
    Returns a hash code value for this object.
    final void
    notify()
    Wakes up a single thread that is waiting on this object's monitor.
    final void
    notifyAll()
    Wakes up all threads that are waiting on this object's monitor.
    String
    toString()
    Returns a string representation of the object.
    final void
    wait()
    Causes the current thread to wait until it is awakened, typically by being notified or interrupted.
    final void
    wait(long timeoutMillis)
    Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.
    final void
    wait(long timeoutMillis, int nanos)
    Causes the current thread to wait until it is awakened, typically by being notified or interrupted, or until a certain amount of real time has elapsed.

  • Field Details

    • RAW_TEXT

      public static final int RAW_TEXT
      Constant for the raw text state.
      See Also:

    • CONVERTED_TEXT

      public static final int CONVERTED_TEXT
      Constant for the converted text state.
      See Also:

    • UNSELECTED_RAW_TEXT_HIGHLIGHT

      public static final InputMethodHighlight UNSELECTED_RAW_TEXT_HIGHLIGHT
      Constant for the default highlight for unselected raw text.

    • SELECTED_RAW_TEXT_HIGHLIGHT

      public static final InputMethodHighlight SELECTED_RAW_TEXT_HIGHLIGHT
      Constant for the default highlight for selected raw text.

    • UNSELECTED_CONVERTED_TEXT_HIGHLIGHT

      public static final InputMethodHighlight UNSELECTED_CONVERTED_TEXT_HIGHLIGHT
      Constant for the default highlight for unselected converted text.

    • SELECTED_CONVERTED_TEXT_HIGHLIGHT

      public static final InputMethodHighlight SELECTED_CONVERTED_TEXT_HIGHLIGHT
      Constant for the default highlight for selected converted text.

  • Constructor Details

    • InputMethodHighlight

      public InputMethodHighlight(boolean selected, int state)
      Constructs an input method highlight record. The variation is set to 0, the style to null.
      Parameters:
      selected - Whether the text range is selected
      state - The conversion state for the text range - RAW_TEXT or CONVERTED_TEXT
      Throws:
      IllegalArgumentException - if a state other than RAW_TEXT or CONVERTED_TEXT is given
      See Also:

    • InputMethodHighlight

      public InputMethodHighlight(boolean selected, int state, int variation)
      Constructs an input method highlight record. The style is set to null.
      Parameters:
      selected - Whether the text range is selected
      state - The conversion state for the text range - RAW_TEXT or CONVERTED_TEXT
      variation - The style variation for the text range
      Throws:
      IllegalArgumentException - if a state other than RAW_TEXT or CONVERTED_TEXT is given
      See Also:

    • InputMethodHighlight

      public InputMethodHighlight(boolean selected, int state, int variation, Map<TextAttribute, ?> style)
      Constructs an input method highlight record. The style attributes map provided must be unmodifiable.
      Parameters:
      selected - whether the text range is selected
      state - the conversion state for the text range - RAW_TEXT or CONVERTED_TEXT
      variation - the variation for the text range
      style - the rendering style attributes for the text range, or null
      Throws:
      IllegalArgumentException - if a state other than RAW_TEXT or CONVERTED_TEXT is given
      Since:
      1.3
      See Also:

  • Method Details

    • isSelected

      public boolean isSelected()
      Returns whether the text range is selected.
      Returns:
      whether the text range is selected

    • getState

      public int getState()
      Returns the conversion state of the text range.
      Returns:
      The conversion state for the text range - RAW_TEXT or CONVERTED_TEXT.
      See Also:

    • getVariation

      public int getVariation()
      Returns the variation of the text range.
      Returns:
      the variation of the text range

    • getStyle

      public Map<TextAttribute, ?> getStyle()
      Returns the rendering style attributes for the text range, or null.
      Returns:
      the rendering style attributes for the text range, or null
      Since:
      1.3