java.awt.event
类 InputEvent

java.lang.Object
  java.util.EventObject
      java.awt.AWTEvent
          java.awt.event.ComponentEvent
              java.awt.event.InputEvent

所有已实现的接口：

Serializable

直接已知子类：

KeyEvent, MouseEvent

public abstract class InputEvent
extends ComponentEvent

所有组件级别输入事件的根事件类。 输入事件通常由产生输入事件的源代码进行处理，而在此之前，将他们提交到侦听器中。这样就允许侦听器和组件子类“使用”事件，以便源代码不会以默认方式处理事件。例如，在 Button 组件上使用 mousePressed 事件将阻止 Button 被激活。

从以下版本开始：

1.1

另请参见：

KeyEvent, KeyAdapter, MouseEvent, MouseAdapter, MouseMotionAdapter, 序列化表格

字段摘要

static int	ALT_DOWN_MASK Alt 键的扩展修饰符常量。
static int	ALT_GRAPH_DOWN_MASK AltGraph 键的扩展修饰符常量。
static int	ALT_GRAPH_MASK AltGraph 键修饰符常量。
static int	ALT_MASK Alt 键修饰符常量。
static int	BUTTON1_DOWN_MASK Mouse Button1 的扩展修饰符常量。
static int	BUTTON1_MASK Mouse Button1 修饰符常量。
static int	BUTTON2_DOWN_MASK Mouse Button2 的扩展修饰符常量。
static int	BUTTON2_MASK Mouse Button2 修饰符常量。
static int	BUTTON3_DOWN_MASK Mouse Button3 的扩展修饰符常量。
static int	BUTTON3_MASK Mouse Button3 修饰符常量。
static int	CTRL_DOWN_MASK Control 键的扩展修饰符常量。
static int	CTRL_MASK Ctrl 键修饰符常量。
static int	META_DOWN_MASK Meta 键的扩展修饰符常量。
static int	META_MASK Meta 键修饰符常量。
static int	SHIFT_DOWN_MASK Shift 键的扩展修饰符常量。
static int	SHIFT_MASK Shift 键修饰符常量。

从类 java.awt.event.ComponentEvent 继承的字段

COMPONENT_FIRST, COMPONENT_HIDDEN, COMPONENT_LAST, COMPONENT_MOVED, COMPONENT_RESIZED, COMPONENT_SHOWN

从类 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

从类 java.util.EventObject 继承的字段

source

方法摘要

void	consume() 使用此事件，以便不会按照默认的方式由产生此事件的源代码来处理此事件。
int	getModifiers() 返回此事件的修饰符掩码。
int	getModifiersEx() 返回此事件的扩展修饰符掩码。
static String	getModifiersExText(int modifiers) 返回描述扩展组合键和鼠标按钮（例如 "Shift"、"Button1" 或 "Ctrl+Shift"）的 String。
long	getWhen() 返回此事件发生时的时间戳。
boolean	isAltDown() 返回 Alt 修饰符在此事件上是否为 down。
boolean	isAltGraphDown() 返回 AltGraph 修饰符在此事件上是否为 down。
boolean	isConsumed() 返回是否已经使用此事件。
boolean	isControlDown() 返回 Control 修饰符在此事件上是为 down。
boolean	isMetaDown() 返回 Meta 修饰符在此事件上是否为 down。
boolean	isShiftDown() 返回 Shift 修饰符在此事件上是否为 down。

从类 java.awt.event.ComponentEvent 继承的方法

getComponent, paramString

从类 java.awt.AWTEvent 继承的方法

getID, setSource, toString

从类 java.util.EventObject 继承的方法

getSource

从类 java.lang.Object 继承的方法

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

字段详细信息

SHIFT_MASK

public static final int SHIFT_MASK

Shift 键修饰符常量。建议使用 SHIFT_DOWN_MASK。

另请参见：

常量字段值

CTRL_MASK

public static final int CTRL_MASK

Ctrl 键修饰符常量。建议使用 CTRL_DOWN_MASK。

另请参见：

常量字段值

META_MASK

public static final int META_MASK

Meta 键修饰符常量。建议使用 META_DOWN_MASK。

另请参见：

常量字段值

ALT_MASK

public static final int ALT_MASK

Alt 键修饰符常量。建议使用 ALT_DOWN_MASK。

另请参见：

常量字段值

ALT_GRAPH_MASK

public static final int ALT_GRAPH_MASK

AltGraph 键修饰符常量。

另请参见：

常量字段值

BUTTON1_MASK

public static final int BUTTON1_MASK

Mouse Button1 修饰符常量。建议使用 BUTTON1_DOWN_MASK。

另请参见：

常量字段值

BUTTON2_MASK

public static final int BUTTON2_MASK

Mouse Button2 修饰符常量。建议使用 BUTTON2_DOWN_MASK。注意，BUTTON2_MASK 和 ALT_MASK 具有相同的值。

另请参见：

常量字段值

BUTTON3_MASK

public static final int BUTTON3_MASK

Mouse Button3 修饰符常量。建议使用 BUTTON3_DOWN_MASK。注意：BUTTON3_MASK 和 META_MASK 具有相同的值。

另请参见：

常量字段值

SHIFT_DOWN_MASK

public static final int SHIFT_DOWN_MASK

Shift 键的扩展修饰符常量。

从以下版本开始：

1.4

另请参见：

常量字段值

CTRL_DOWN_MASK

public static final int CTRL_DOWN_MASK

Control 键的扩展修饰符常量。

从以下版本开始：

1.4

另请参见：

常量字段值

META_DOWN_MASK

public static final int META_DOWN_MASK

Meta 键的扩展修饰符常量。

从以下版本开始：

1.4

另请参见：

常量字段值

ALT_DOWN_MASK

public static final int ALT_DOWN_MASK

Alt 键的扩展修饰符常量。

从以下版本开始：

1.4

另请参见：

常量字段值

BUTTON1_DOWN_MASK

public static final int BUTTON1_DOWN_MASK

Mouse Button1 的扩展修饰符常量。

从以下版本开始：

1.4

另请参见：

常量字段值

BUTTON2_DOWN_MASK

public static final int BUTTON2_DOWN_MASK

Mouse Button2 的扩展修饰符常量。

从以下版本开始：

1.4

另请参见：

常量字段值

BUTTON3_DOWN_MASK

public static final int BUTTON3_DOWN_MASK

Mouse Button3 的扩展修饰符常量。

从以下版本开始：

1.4

另请参见：

常量字段值

ALT_GRAPH_DOWN_MASK

public static final int ALT_GRAPH_DOWN_MASK

AltGraph 键的扩展修饰符常量。

从以下版本开始：

1.4

另请参见：

常量字段值

方法详细信息

isShiftDown

public boolean isShiftDown()

返回 Shift 修饰符在此事件上是否为 down。

isControlDown

public boolean isControlDown()

返回 Control 修饰符在此事件上是为 down。

isMetaDown

public boolean isMetaDown()

返回 Meta 修饰符在此事件上是否为 down。

isAltDown

public boolean isAltDown()

返回 Alt 修饰符在此事件上是否为 down。

isAltGraphDown

public boolean isAltGraphDown()

返回 AltGraph 修饰符在此事件上是否为 down。

getWhen

public long getWhen()

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

getModifiers

public int getModifiers()

返回此事件的修饰符掩码。

getModifiersEx

public int getModifiersEx()

返回此事件的扩展修饰符掩码。扩展修饰符表示所有模式键的状态，例如 ALT、CTRL、META 和事件发生后那一刻的鼠标按钮

例如，如果用户在按下 button 1 后又按下 button 2，然后以相同的顺序释放这两个按钮，则会生成以下事件序列：

    MOUSE_PRESSED: BUTTON1_DOWN_MASK
    MOUSE_PRESSED: BUTTON1_DOWN_MASK | BUTTON2_DOWN_MASK
    MOUSE_RELEASED: BUTTON2_DOWN_MASK
    MOUSE_CLICKED: BUTTON2_DOWN_MASK
    MOUSE_RELEASED: 
    MOUSE_CLICKED:  
 

建议不使用 == 来比较此方法的返回值，因为在以后会增加新的修饰符。例如，检查 SHIFT 和 BUTTON1 已经按下而 CTRL 未按下的正确方法可以通过以下代码来演示：

    int onmask = SHIFT_DOWN_MASK | BUTTON1_DOWN_MASK;
    int offmask = CTRL_DOWN_MASK;
    if (event.getModifiersEx() & (onmask | offmask) == onmask) {
        ...
    }
 

即使添加了新的修饰符，上述代码仍然有效。

从以下版本开始：

1.4

consume

public void consume()

使用此事件，以便不会按照默认的方式由产生此事件的源代码来处理此事件。

覆盖：

类 AWTEvent 中的 consume

isConsumed

public boolean isConsumed()

返回是否已经使用此事件。

覆盖：

类 AWTEvent 中的 isConsumed

另请参见：

consume()

getModifiersExText

public static String getModifiersExText(int modifiers)

返回描述扩展组合键和鼠标按钮（例如 "Shift"、"Button1" 或 "Ctrl+Shift"）的 String。这些字符串的本地化可以通过修改 awt.properties 文件来完成。

参数：

modifiers - 描述事件的扩展修饰符和鼠标按钮的修饰符掩码

返回：

事件期间保存按下的扩展组合键和鼠标按钮集合的文本描述。

从以下版本开始：

1.4