java.awt.event

Class InputMethodEvent

java.lang.Object

java.util.EventObject

java.awt.AWTEvent

java.awt.event.InputMethodEvent

All Implemented Interfaces:

Serializable

public class InputMethodEvent
extends AWTEvent

输入方法事件包含正在使用的输入法所组成的文本的信息。每当文本发生更改时，输入方法将发送一个事件。如果当前使用输入法的文本组件是一个活动客户端，则事件将被发送到该组件上。否则，它被发送到一个单独的组合窗口。

输入法事件包含的文本由两部分组成：提交文本和组成文本。任何一部分都可能是空的。在一起的两个部分取代任何未提交的正文前的事件发送，或当前选定的承诺文本。将提交的文本应集成到文本组件的持久数据中，将不会再次发送。组合的文本可以重复发送，用更改来反映用户的编辑操作。承诺文本总是先于组合文本。

从以下版本开始：

一点二

另请参见：

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
static int	CARET_POSITION_CHANGED 在输入法文本中表示更改的插入点的事件类型。
static int	INPUT_METHOD_FIRST 标记输入法事件标识的范围的第一个整数标识。
static int	INPUT_METHOD_LAST 标记输入法事件标识的范围的最后一个整数标识。
static int	INPUT_METHOD_TEXT_CHANGED 事件类型指示更改输入法文本。

Fields inherited from class java.awt.AWTEvent

ACTION_EVENT_MASK, ADJUSTMENT_EVENT_MASK, COMPONENT_EVENT_MASK, consumed, CONTAINER_EVENT_MASK, FOCUS_EVENT_MASK, HIERARCHY_BOUNDS_EVENT_MASK, HIERARCHY_EVENT_MASK, id, INPUT_METHOD_EVENT_MASK, INVOCATION_EVENT_MASK, ITEM_EVENT_MASK, KEY_EVENT_MASK, MOUSE_EVENT_MASK, MOUSE_MOTION_EVENT_MASK, MOUSE_WHEEL_EVENT_MASK, PAINT_EVENT_MASK, RESERVED_ID_MAX, TEXT_EVENT_MASK, WINDOW_EVENT_MASK, WINDOW_FOCUS_EVENT_MASK, WINDOW_STATE_EVENT_MASK

Fields inherited from class java.util.EventObject

source

构造方法摘要

构造方法

Constructor and Description
InputMethodEvent(Component source, int id, AttributedCharacterIterator text, int committedCharacterCount, TextHitInfo caret, TextHitInfo visiblePosition) 构建具有指定源组件，一个 InputMethodEvent型，文字，符号，和visibleposition。
InputMethodEvent(Component source, int id, long when, AttributedCharacterIterator text, int committedCharacterCount, TextHitInfo caret, TextHitInfo visiblePosition) 构建具有指定源组件，一个 InputMethodEvent类型，时间，文字，符号，和visibleposition。
InputMethodEvent(Component source, int id, TextHitInfo caret, TextHitInfo visiblePosition) 构建具有指定源组件，一个 InputMethodEvent型，符号，和visibleposition。

方法摘要

Modifier and Type	Method and Description
void	consume() 消耗此事件，以便它不会以源代码的源程序在默认情况下处理它。
TextHitInfo	getCaret() 获取插入符号。
int	getCommittedCharacterCount() 获取文本中提交的字符数。
AttributedCharacterIterator	getText() 获取组合的提交和组合文本。
TextHitInfo	getVisiblePosition() 获取最重要的是可见的位置。
long	getWhen() 返回此事件发生时的时间戳。
boolean	isConsumed() 返回此事件是否已被消耗。
String	paramString() 返回标识此事件的参数字符串。

Methods inherited from class java.awt.AWTEvent

getID, setSource, toString

Methods inherited from class java.util.EventObject

getSource

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

INPUT_METHOD_FIRST

@Native
public static final int INPUT_METHOD_FIRST

标记输入法事件标识的范围的第一个整数标识。

另请参见：

Constant Field Values

INPUT_METHOD_TEXT_CHANGED

@Native
public static final int INPUT_METHOD_TEXT_CHANGED

事件类型指示更改输入法文本。此事件是通过输入方法产生的，而处理输入。

另请参见：

Constant Field Values

CARET_POSITION_CHANGED

@Native
public static final int CARET_POSITION_CHANGED

在输入法文本中表示更改的插入点的事件类型。此事件是由输入的方法产生的，如果只插入改变输入处理。

另请参见：

Constant Field Values

INPUT_METHOD_LAST

@Native
public static final int INPUT_METHOD_LAST

标记输入法事件标识的范围的最后一个整数标识。

另请参见：

Constant Field Values

Constructor Detail

InputMethodEvent

public InputMethodEvent(Component source,
                        int id,
                        long when,
                        AttributedCharacterIterator text,
                        int committedCharacterCount,
                        TextHitInfo caret,
                        TextHitInfo visiblePosition)

构建具有指定源组件，一个 InputMethodEvent类型，时间，文字，符号，和visibleposition。

的符号和visibleposition偏移量是相对于当前正文；即构成文本在text如果这是一个INPUT_METHOD_TEXT_CHANGED事件组成的文本，在text前述INPUT_METHOD_TEXT_CHANGED事件否则。

请注意，通过在指定的行为无效id结果。该方法抛出一个IllegalArgumentException如果source是null。

参数

source -对象，事件的起源

id -事件类型

when -一个长整数，指定事件发生的时间

text -联合致力于和正文，首先必须 null承诺；当事件类型是 CARET_POSITION_CHANGED；可能 null为 INPUT_METHOD_TEXT_CHANGED如果没有提交或正文

committedCharacterCount在文字承诺的字符数

caret -插入符号（即插入点）； null如果没有插入在当前正文

visiblePosition的位置，最重要的是可见的； null如果没有推荐在当前正文可见位置

异常

IllegalArgumentException -如果 id不在范围 INPUT_METHOD_FIRST .. INPUT_METHOD_LAST；或如果我是 CARET_POSITION_CHANGED和 text不 null；或者如果 committedCharacterCount不在范围 (text.getEndIndex() - text.getBeginIndex()) 0 ..

IllegalArgumentException -如果 source是空的

从以下版本开始：

一点四

InputMethodEvent

public InputMethodEvent(Component source,
                        int id,
                        AttributedCharacterIterator text,
                        int committedCharacterCount,
                        TextHitInfo caret,
                        TextHitInfo visiblePosition)

构建具有指定源组件，一个 InputMethodEvent型，文字，符号，和visibleposition。

的符号和visibleposition偏移量是相对于当前正文；即构成文本在text如果这是一个INPUT_METHOD_TEXT_CHANGED事件组成的文本，在text前述INPUT_METHOD_TEXT_CHANGED事件否则。时间对这一事件的邮票是通过调用EventQueue.getMostRecentEventTime()初始化。

请注意，通过在指定的行为无效id结果。该方法抛出一个IllegalArgumentException如果source是null。

参数

source -对象，事件的起源

id -事件类型

text -联合致力于和正文，首先必须 null承诺；当事件类型是 CARET_POSITION_CHANGED；可能 null为 INPUT_METHOD_TEXT_CHANGED如果没有提交或正文

committedCharacterCount在文字承诺的字符数

caret -插入符号（即插入点）； null如果没有插入在当前正文

visiblePosition的位置，最重要的是可见的； null如果没有推荐在当前正文可见位置

异常

IllegalArgumentException -如果 id不在范围 INPUT_METHOD_FIRST .. INPUT_METHOD_LAST；或如果我是 CARET_POSITION_CHANGED和 text不 null；或者如果 committedCharacterCount不在范围 (text.getEndIndex() - text.getBeginIndex()) 0 ..

IllegalArgumentException -如果 source是空的

InputMethodEvent

public InputMethodEvent(Component source,
                        int id,
                        TextHitInfo caret,
                        TextHitInfo visiblePosition)

构建具有指定源组件，一个 InputMethodEvent型，符号，和visibleposition。本文将 null， committedCharacterCount 0。

对caret和visiblePosition偏移量是相对于当前正文；即构成文本在前INPUT_METHOD_TEXT_CHANGED事件text如果事件被构建为一个CARET_POSITION_CHANGED事件。对于一个没有文字INPUT_METHOD_TEXT_CHANGED事件，caret和visiblePosition必须null。时间对这一事件的邮票是通过调用EventQueue.getMostRecentEventTime()初始化。

请注意，通过在指定的行为无效id结果。该方法抛出一个IllegalArgumentException如果source是null。

参数

source -对象，事件的起源

id -事件类型

caret -插入符号（即插入点）； null如果没有插入在当前正文

visiblePosition的位置，最重要的是可见的； null如果没有推荐在当前正文可见位置

异常

IllegalArgumentException -如果 id不在范围 INPUT_METHOD_LAST INPUT_METHOD_FIRST ..

IllegalArgumentException -如果 source是空的

方法详细信息

getText

public AttributedCharacterIterator getText()

获取组合的提交和组合文本。从索引0索引 getCommittedCharacterCount() - 1人物致力于文本，其余的字符组成的文本。

结果

文本。总是空caret_position_changed；可能是无效的input_method_text_changed如果没有由文本或承诺。

getCommittedCharacterCount

public int getCommittedCharacterCount()

获取文本中提交的字符数。

getCaret

public TextHitInfo getCaret()

获取插入符号。

插入符号的偏移量是相对于当前正文；即构成文本在gettext()如果这是一个INPUT_METHOD_TEXT_CHANGED事件组成的文本，在gettext()前述INPUT_METHOD_TEXT_CHANGED事件否则。

结果

插入符号（即插入点）。空如果没有插入在当前正文。

getVisiblePosition

public TextHitInfo getVisiblePosition()

获取最重要的是可见的位置。

可见的位置偏移量是相对于当前正文；即构成文本在gettext()如果这是一个INPUT_METHOD_TEXT_CHANGED事件组成的文本，在gettext()前述INPUT_METHOD_TEXT_CHANGED事件否则。

结果

最重要的位置是可见的。如果没有在当前组成的文本中的可见位置的建议。

consume

public void consume()

消耗此事件，以便它不会以源代码的源程序在默认情况下处理它。

重写：

consume 方法重写，继承类 AWTEvent

isConsumed

public boolean isConsumed()

返回此事件是否已被消耗。

重写：

isConsumed 方法重写，继承类 AWTEvent

另请参见：

consume()

getWhen

public long getWhen()

返回此事件发生时的时间戳。

结果

这一事件的时间戳

从以下版本开始：

一点四

paramString

public String paramString()

返回标识此事件的参数字符串。此方法用于事件日志记录和调试是有用的。它包含文本形式的事件，人物的承诺和正文之间用“+”，致力于人物，数的符号，并可见位置。

重写：

paramString 方法重写，继承类 AWTEvent

结果

识别事件及其属性的字符串