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, 序列化表格

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