InputEvent (Java Platform SE 8 )

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

All Implemented Interfaces:

Serializable

已知直接子类：

KeyEvent ， MouseEvent
```
public abstract class InputEvent
extends ComponentEvent
```
所有组件级输入事件的根事件类。输入事件在它们发起的源正常处理之前传递给收听者。这允许侦听器和组件子类“消耗”事件，以便源将不会以其默认方式处理它们。例如，在Button组件上使用mousePressed事件将阻止Button被激活。

从以下版本开始：

1.1

另请参见：

KeyEvent ， KeyAdapter ， MouseEvent ， MouseAdapter ， MouseMotionAdapter ， Serialized Form

Field Summary

Fields
Modifier and Type	Field and Description
`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` 鼠标Button1扩展修饰符常数。
`static int`	`BUTTON1_MASK` 鼠标Button1修饰符常量。
`static int`	`BUTTON2_DOWN_MASK` 鼠标Button2扩展修饰符常数。
`static int`	`BUTTON2_MASK` 鼠标Button2修饰符常量。
`static int`	`BUTTON3_DOWN_MASK` 鼠标Button3扩展修饰符常数。
`static int`	`BUTTON3_MASK` 鼠标Button3修饰符常量。
`static int`	`CTRL_DOWN_MASK` 控制键扩展修改常数。
`static int`	`CTRL_MASK` 控制键修饰符常数。
`static int`	`META_DOWN_MASK` Meta键扩展修饰符常数。
`static int`	`META_MASK` 元键修饰符常数。
`static int`	`SHIFT_DOWN_MASK` Shift键扩展修饰符常数。
`static int`	`SHIFT_MASK` Shift键修饰符常数。

Fields inherited from class java.awt.event.ComponentEvent
COMPONENT_FIRST, COMPONENT_HIDDEN, COMPONENT_LAST, COMPONENT_MOVED, COMPONENT_RESIZED, COMPONENT_SHOWN

Fields inherited from class java.util.EventObject
source

方法摘要

所有方法静态方法接口方法具体的方法
Modifier and Type	Method and Description
`void`	`consume()` 消耗此事件，使其不会以源自源的默认方式处理。
`static int`	`getMaskForButton(int button)` 获取任何现有鼠标按钮的掩码的方法。
`int`	`getModifiers()` 返回此事件的修饰符掩码。
`int`	`getModifiersEx()` 返回此事件的扩展修饰符掩码。
`static String`	`getModifiersExText(int modifiers)` 返回一个描述扩展修饰符键和鼠标按钮的字符串，例如“Shift”，“Button1”或“Ctrl + Shift”。
`long`	`getWhen()` 返回此事件发生的时间戳与1970年1月1日UTC之间的毫秒之间的差异。
`boolean`	`isAltDown()` 返回此事件的Alt修饰符是否关闭。
`boolean`	`isAltGraphDown()` 返回此事件的AltGraph修饰符是否关闭。
`boolean`	`isConsumed()` 返回此事件是否已被使用。
`boolean`	`isControlDown()` 返回此修改器是否关闭此事件。
`boolean`	`isMetaDown()` 返回Meta修饰符在此事件上是否关闭。
`boolean`	`isShiftDown()` 返回此事件的Shift修饰符是否关闭。

Methods inherited from class java.awt.event.ComponentEvent
getComponent, 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

- 字段详细信息
  - SHIFT_MASK
```
public static final int SHIFT_MASK
```
    Shift键修饰符常数。建议使用SHIFT_DOWN_MASK。
    
    另请参见：
    
    Constant Field Values
  - CTRL_MASK
```
public static final int CTRL_MASK
```
    控制键修饰符常数。建议使用CTRL_DOWN_MASK。
    
    另请参见：
    
    Constant Field Values
  - META_MASK
```
public static final int META_MASK
```
    元键修饰符常数。建议使用META_DOWN_MASK。
    
    另请参见：
    
    Constant Field Values
  - ALT_MASK
```
public static final int ALT_MASK
```
    Alt键修饰符常数。建议使用ALT_DOWN_MASK。
    
    另请参见：
    
    Constant Field Values
  - ALT_GRAPH_MASK
```
public static final int ALT_GRAPH_MASK
```
    AltGraph键修饰符常数。
    
    另请参见：
    
    Constant Field Values
  - BUTTON1_MASK
```
public static final int BUTTON1_MASK
```
    鼠标Button1修饰符常量。建议使用BUTTON1_DOWN_MASK。
    
    另请参见：
    
    Constant Field Values
  - BUTTON2_MASK
```
public static final int BUTTON2_MASK
```
    鼠标Button2修饰符常量。建议使用BUTTON2_DOWN_MASK。请注意，BUTTON2_MASK的值与ALT_MASK相同。
    
    另请参见：
    
    Constant Field Values
  - BUTTON3_MASK
```
public static final int BUTTON3_MASK
```
    鼠标Button3修饰符常量。建议使用BUTTON3_DOWN_MASK。请注意，BUTTON3_MASK与META_MASK具有相同的值。
    
    另请参见：
    
    Constant Field Values
  - SHIFT_DOWN_MASK
```
public static final int SHIFT_DOWN_MASK
```
    Shift键扩展修饰符常数。
    
    从以下版本开始：
    
    1.4
    
    另请参见：
    
    Constant Field Values
  - CTRL_DOWN_MASK
```
public static final int CTRL_DOWN_MASK
```
    控制键扩展修改常数。
    
    从以下版本开始：
    
    1.4
    
    另请参见：
    
    Constant Field Values
  - META_DOWN_MASK
```
public static final int META_DOWN_MASK
```
    Meta键扩展修饰符常数。
    
    从以下版本开始：
    
    1.4
    
    另请参见：
    
    Constant Field Values
  - ALT_DOWN_MASK
```
public static final int ALT_DOWN_MASK
```
    Alt键扩展修饰符常数。
    
    从以下版本开始：
    
    1.4
    
    另请参见：
    
    Constant Field Values
  - BUTTON1_DOWN_MASK
```
public static final int BUTTON1_DOWN_MASK
```
    鼠标Button1扩展修饰符常数。
    
    从以下版本开始：
    
    1.4
    
    另请参见：
    
    Constant Field Values
  - BUTTON2_DOWN_MASK
```
public static final int BUTTON2_DOWN_MASK
```
    鼠标Button2扩展修饰符常数。
    
    从以下版本开始：
    
    1.4
    
    另请参见：
    
    Constant Field Values
  - BUTTON3_DOWN_MASK
```
public static final int BUTTON3_DOWN_MASK
```
    鼠标Button3扩展修饰符常数。
    
    从以下版本开始：
    
    1.4
    
    另请参见：
    
    Constant Field Values
  - ALT_GRAPH_DOWN_MASK
```
public static final int ALT_GRAPH_DOWN_MASK
```
    AltGraph键扩展修饰符常数。
    
    从以下版本开始：
    
    1.4
    
    另请参见：
    
    Constant Field Values
- 方法详细信息
  - getMaskForButton
```
public static int getMaskForButton(int button)
```
    获取任何现有鼠标按钮的掩码的方法。返回的面罩可以用于不同的目的。以下是其中的一些：
    - mousePress(buttons)和mouseRelease(buttons)
    - 为modifiers参数创建一个新的时MouseEvent实例
    - 检查modifiersEx现有MouseEvent
    参数
    button - 是一个从1开始的按钮的数字。例如，
    int button = InputEvent.getMaskForButton(1);
    将具有相同的含义
    int button = InputEvent.getMaskForButton(MouseEvent.BUTTON1);
    因为MouseEvent.BUTTON1等于1.如果鼠标有三个启用的按钮（参见MouseInfo.getNumberOfButtons() ），则传入方法的左列的值将从右列返回相应的值：
    button returned mask BUTTON1 BUTTON1_DOWN_MASK BUTTON2 BUTTON2_DOWN_MASK BUTTON3 BUTTON3_DOWN_MASK
    如果鼠标有三个以上的启用按钮，则可以允许更多的值（4,5等）。这些扩展按钮没有分配的常量。此方法返回的额外按钮的按钮掩码没有分配的名称，如前三个按钮蒙版。
    该方法具有以下实现限制。它只返回有限数量按钮的遮罩。最大数量取决于实现，可能会有所不同。该限制由鼠标可能假设存在的按钮的相关数量定义，但大于MouseInfo.getNumberOfButtons() 。
    异常
    
    IllegalArgumentException - 如果 button小于零或大于为按钮保留的按钮面具数量
    
    从以下版本开始：
    
    7.0
    
    另请参见：
    
    MouseInfo.getNumberOfButtons() ， Toolkit.areExtraMouseButtonsEnabled() ， getModifiers() ， MouseEvent.getModifiersEx()
  - isShiftDown
```
public boolean isShiftDown()
```
    返回此事件的Shift修饰符是否关闭。
  - isControlDown
```
public boolean isControlDown()
```
    返回此修改器是否关闭此事件。
  - isMetaDown
```
public boolean isMetaDown()
```
    返回Meta修饰符在此事件上是否关闭。
  - isAltDown
```
public boolean isAltDown()
```
    返回此事件的Alt修饰符是否关闭。
  - isAltGraphDown
```
public boolean isAltGraphDown()
```
    返回此事件的AltGraph修饰符是否关闭。
  - getWhen
```
public long getWhen()
```
    返回此事件发生的时间戳与1970年1月1日UTC之间的毫秒之间的差异。
  - getModifiers
```
public int getModifiers()
```
    返回此事件的修饰符掩码。
  - getModifiersEx
```
public int getModifiersEx()
```
    返回此事件的扩展修饰符掩码。
    扩展修饰符是以_DOWN_MASK后缀结尾的修饰符，如ALT_DOWN_MASK，BUTTON1_DOWN_MASK等。
    
    扩展修饰符表示所有模态键的状态，如ALT，CTRL，META和事件发生后的鼠标按钮。
    
    例如，如果用户按下按钮1跟随按钮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()
```
    消耗此事件，使其不会以源自源的默认方式处理。
    
    重写：
    
    consume在 AWTEvent
  - isConsumed
```
public boolean isConsumed()
```
    返回此事件是否已被使用。
    
    重写：
    
    isConsumed在类别 AWTEvent
    
    另请参见：
    
    consume()
  - getModifiersExText
```
public static String getModifiersExText(int modifiers)
```
    返回一个描述扩展修饰符键和鼠标按钮的字符串，例如“Shift”，“Button1”或“Ctrl + Shift”。这些字符串可以通过更改awt.properties文件进行awt.properties 。
    请注意，传递负参数不正确，将返回未指定的字符串。零参数意味着没有修改器被传递并且将导致返回一个空字符串。
    
    参数
    
    modifiers - 描述事件的扩展修饰符键和鼠标按钮的修饰符掩码
    
    结果
    
    在事件期间按住的扩展修饰键和鼠标按钮的组合的文本描述。
    
    从以下版本开始：
    
    1.4

Class InputEvent

Field Summary

Fields inherited from class java.awt.event.ComponentEvent

Fields inherited from class java.awt.AWTEvent

Fields inherited from class java.util.EventObject

方法摘要

Methods inherited from class java.awt.event.ComponentEvent

Methods inherited from class java.awt.AWTEvent

Methods inherited from class java.util.EventObject

Methods inherited from class java.lang.Object

字段详细信息

SHIFT_MASK

CTRL_MASK

META_MASK

ALT_MASK

ALT_GRAPH_MASK

BUTTON1_MASK

BUTTON2_MASK

BUTTON3_MASK

SHIFT_DOWN_MASK

CTRL_DOWN_MASK

META_DOWN_MASK

ALT_DOWN_MASK

BUTTON1_DOWN_MASK

BUTTON2_DOWN_MASK

BUTTON3_DOWN_MASK

ALT_GRAPH_DOWN_MASK

方法详细信息

getMaskForButton

isShiftDown

isControlDown

isMetaDown

isAltDown

isAltGraphDown

getWhen

getModifiers

getModifiersEx

consume

isConsumed

getModifiersExText