- 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 useToolkit.mapInputMethodHighlight(java.awt.im.InputMethodHighlight)
to map to a concrete style.The abstract description consists of three fields:
selected
,state
, andvariation
.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. Thevariation
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:
AttributedCharacterIterator
-
-
Field Summary
Fields Modifier and Type Field and Description static int
CONVERTED_TEXT
Constant for the converted text state.static int
RAW_TEXT
Constant for the raw text state.static InputMethodHighlight
SELECTED_CONVERTED_TEXT_HIGHLIGHT
Constant for the default highlight for selected converted text.static InputMethodHighlight
SELECTED_RAW_TEXT_HIGHLIGHT
Constant for the default highlight for selected raw text.static InputMethodHighlight
UNSELECTED_CONVERTED_TEXT_HIGHLIGHT
Constant for the default highlight for unselected converted text.static InputMethodHighlight
UNSELECTED_RAW_TEXT_HIGHLIGHT
Constant for the default highlight for unselected raw text.
-
Constructor Summary
Constructors Constructor and 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
Methods Modifier and Type Method and 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.
-
-
-
Field Detail
-
RAW_TEXT
public static final int RAW_TEXT
Constant for the raw text state.- See Also:
- Constant Field Values
-
CONVERTED_TEXT
public static final int CONVERTED_TEXT
Constant for the converted text state.- See Also:
- Constant Field Values
-
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 Detail
-
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 selectedstate
- 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:
RAW_TEXT
,CONVERTED_TEXT
-
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 selectedstate
- The conversion state for the text range - RAW_TEXT or CONVERTED_TEXTvariation
- The style variation for the text range- Throws:
IllegalArgumentException
- if a state other than RAW_TEXT or CONVERTED_TEXT is given- See Also:
RAW_TEXT
,CONVERTED_TEXT
-
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 selectedstate
- the conversion state for the text range - RAW_TEXT or CONVERTED_TEXTvariation
- the variation for the text rangestyle
- 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:
RAW_TEXT
,CONVERTED_TEXT
-
-
Method Detail
-
isSelected
public boolean isSelected()
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:
RAW_TEXT
,CONVERTED_TEXT
-
getVariation
public int getVariation()
Returns the variation of the text range.
-
getStyle
public Map<TextAttribute,?> getStyle()
Returns the rendering style attributes for the text range, or null.- Since:
- 1.3
-
-
Deutsche Übersetzung
Sie haben gebeten, diese Seite auf Deutsch zu besuchen. Momentan ist nur die Oberfläche übersetzt, aber noch nicht der gesamte Inhalt.Wenn Sie mir bei Übersetzungen helfen wollen, ist Ihr Beitrag willkommen. Alles, was Sie tun müssen, ist, sich auf der Website zu registrieren und mir eine Nachricht zu schicken, in der Sie gebeten werden, Sie der Gruppe der Übersetzer hinzuzufügen, die Ihnen die Möglichkeit gibt, die gewünschten Seiten zu übersetzen. Ein Link am Ende jeder übersetzten Seite zeigt an, dass Sie der Übersetzer sind und einen Link zu Ihrem Profil haben.
Vielen Dank im Voraus.
Dokument erstellt 11/06/2005, zuletzt geändert 04/03/2020
Quelle des gedruckten Dokuments:https://www.gaudry.be/de/java-api-rf-java/awt/im/inputmethodhighlight.html
Die Infobro ist eine persönliche Seite, deren Inhalt in meiner alleinigen Verantwortung liegt. Der Text ist unter der CreativeCommons-Lizenz (BY-NC-SA) verfügbar. Weitere Informationen auf die Nutzungsbedingungen und dem Autor.
Referenzen
Diese Verweise und Links verweisen auf Dokumente, die während des Schreibens dieser Seite konsultiert wurden, oder die zusätzliche Informationen liefern können, aber die Autoren dieser Quellen können nicht für den Inhalt dieser Seite verantwortlich gemacht werden.
Der Autor Diese Website ist allein dafür verantwortlich, wie die verschiedenen Konzepte und Freiheiten, die mit den Nachschlagewerken gemacht werden, hier dargestellt werden. Denken Sie daran, dass Sie mehrere Quellinformationen austauschen müssen, um das Risiko von Fehlern zu reduzieren.