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
```
用于所有组件级输入事件的根事件类。输入事件传递给听众之前，他们通常是由他们起源的来源。这允许侦听器和组件子类“消耗”事件，以便源不会以默认的方式处理它们。例如，消费mousePressed事件在按钮元件可以防止按钮被激活。

从以下版本开始：

一点一

另请参见：

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` 鼠标按钮2剂不断扩展。
`static int`	`BUTTON2_MASK` 鼠标按钮2修正常数。
`static int`	`BUTTON3_DOWN_MASK` 鼠标按钮扩展修正常数。
`static int`	`BUTTON3_MASK` 鼠标按钮修正常数。
`static int`	`CTRL_DOWN_MASK` 控制键扩展改性常数。
`static int`	`CTRL_MASK` 控制键改性常数。
`static int`	`META_DOWN_MASK` 元键扩展改性常数。
`static int`	`META_MASK` 元键改性常数。
`static int`	`SHIFT_DOWN_MASK` 移位键扩展改性常数。
`static int`	`SHIFT_MASK` 移位键改性常数。

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)` 返回一个描述扩展的修饰键和鼠标按钮的字符串，如“移”、“Button1”，或“Ctrl + Shift”。
`long`	`getWhen()` 返回的时间戳在毫秒之间的差异这一事件发生时和午夜，1970年1月1日UTC。
`boolean`	`isAltDown()` 返回是否ALT改性剂倒在事件。
`boolean`	`isAltGraphDown()` 返回是否altgraph剂倒在事件。
`boolean`	`isConsumed()` 返回此事件是否已被消耗。
`boolean`	`isControlDown()` 返回是否在此事件中控制修改剂是否关闭。
`boolean`	`isMetaDown()` 返回是否在这个事件上的元修饰语是否是向下的。
`boolean`	`isShiftDown()` 返回是否在这个事件中是否向下移动修改剂。

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

- Field Detail
  - SHIFT_MASK
```
public static final int SHIFT_MASK
```
    移位键改性常数。建议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
```
    鼠标按钮2修正常数。建议button2_down_mask代替。注意，button2_mask具有alt_mask相同的值。
    
    另请参见：
    
    Constant Field Values
  - BUTTON3_MASK
```
public static final int BUTTON3_MASK
```
    鼠标按钮修正常数。建议button3_down_mask代替。注意，button3_mask具有meta_mask相同的值。
    
    另请参见：
    
    Constant Field Values
  - SHIFT_DOWN_MASK
```
public static final int SHIFT_DOWN_MASK
```
    移位键扩展改性常数。
    
    从以下版本开始：
    
    一点四
    
    另请参见：
    
    Constant Field Values
  - CTRL_DOWN_MASK
```
public static final int CTRL_DOWN_MASK
```
    控制键扩展改性常数。
    
    从以下版本开始：
    
    一点四
    
    另请参见：
    
    Constant Field Values
  - META_DOWN_MASK
```
public static final int META_DOWN_MASK
```
    元键扩展改性常数。
    
    从以下版本开始：
    
    一点四
    
    另请参见：
    
    Constant Field Values
  - ALT_DOWN_MASK
```
public static final int ALT_DOWN_MASK
```
    ALT键扩展修正常数。
    
    从以下版本开始：
    
    一点四
    
    另请参见：
    
    Constant Field Values
  - BUTTON1_DOWN_MASK
```
public static final int BUTTON1_DOWN_MASK
```
    鼠标Button1扩展剂常数。
    
    从以下版本开始：
    
    一点四
    
    另请参见：
    
    Constant Field Values
  - BUTTON2_DOWN_MASK
```
public static final int BUTTON2_DOWN_MASK
```
    鼠标按钮2剂不断扩展。
    
    从以下版本开始：
    
    一点四
    
    另请参见：
    
    Constant Field Values
  - BUTTON3_DOWN_MASK
```
public static final int BUTTON3_DOWN_MASK
```
    鼠标按钮扩展修正常数。
    
    从以下版本开始：
    
    一点四
    
    另请参见：
    
    Constant Field Values
  - ALT_GRAPH_DOWN_MASK
```
public static final int ALT_GRAPH_DOWN_MASK
```
    关键的altgraph扩展修正常数。
    
    从以下版本开始：
    
    一点四
    
    另请参见：
    
    Constant Field Values
- 方法详细信息
  - getMaskForButton
```
public static int getMaskForButton(int button)
```
    获得任何现有鼠标按钮的掩码的方法。返回的掩模可用于不同的用途。以下是其中一些：
    - mousePress(buttons)和mouseRelease(buttons)
    - 作为一个modifiers参数创建一个新的MouseEvent实例时
    - 检查现有的MouseEvent modifiersEx
    参数
    button -是一个数字代表一个按钮从1开始。例如，
    int按钮= inputevent getmaskforbutton（1）；
    将具有相同的含义
    int按钮= inputevent。getmaskforbutton（MouseEvent。button1）；
    因为 MouseEvent.BUTTON1等于1。如果鼠标有三个功能按钮（见 MouseInfo.getNumberOfButtons()）然后从传递到方法的左栏的值将对应的值从右栏的回报：
    按钮 返回遮罩BUTTON1 BUTTON1_DOWN_MASKBUTTON2 BUTTON2_DOWN_MASKBUTTON3 BUTTON3_DOWN_MASK
    老鼠如果有超过三启用按钮然后更值容许的（4，5，等）。这些扩展按钮没有指定的常量。此方法返回的额外按钮的按钮掩码没有指定的名称，如前三个按钮掩码。
    此方法具有以下实现限制。它只返回有限数量的按钮的掩码。的最大数量是依赖于实现的，可能会有所不同。这个限制是由按键的相关定义，假设可能对小鼠存在但却比MouseInfo.getNumberOfButtons()。
    异常
    
    IllegalArgumentException -如果 button小于零或大于按钮面具在按钮的数量
    
    从以下版本开始：
    
    七
    
    另请参见：
    
    MouseInfo.getNumberOfButtons()， Toolkit.areExtraMouseButtonsEnabled()， getModifiers()， MouseEvent.getModifiersEx()
  - isShiftDown
```
public boolean isShiftDown()
```
    返回是否在这个事件中是否向下移动修改剂。
  - isControlDown
```
public boolean isControlDown()
```
    返回是否在此事件中控制修改剂是否关闭。
  - isMetaDown
```
public boolean isMetaDown()
```
    返回是否在这个事件上的元修饰语是否是向下的。
  - 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，元，和刚刚发生的事件的鼠标按钮。
    
    例如，如果用户按按钮1随后按钮2，然后释放他们以相同的顺序，产生了以下的事件序列：
```
MOUSE_PRESSED：BUTTON1_DOWN_MASKMOUSE_PRESSED：BUTTON1_DOWN_MASK | BUTTON2_DOWN_MASKMOUSE_RELEASED：BUTTON2_DOWN_MASKMOUSE_CLICKED：BUTTON2_DOWN_MASKMOUSE_RELEASED：MOUSE_CLICKED：
```
    不建议将返回值使用这种方法==因为新修饰符可以说在未来。例如，检查转向及Button1下降的适当方式，但Ctrl是由下面的代码演示了：
```
国际onmask = shift_down_mask | button1_down_mask；国际offmask = ctrl_down_mask；如果（（事件。getmodifiersex() &（onmask | offmask））= = onmask）{…}
```
    上面的代码将即使添加新的修饰工作。
    从以下版本开始：
    
    一点四
  - consume
```
public void consume()
```
    消耗此事件，以便它不会以源代码的源程序在默认情况下处理它。
    
    重写：
    
    consume 方法重写，继承类 AWTEvent
  - isConsumed
```
public boolean isConsumed()
```
    返回此事件是否已被消耗。
    
    重写：
    
    isConsumed 方法重写，继承类 AWTEvent
    
    另请参见：
    
    consume()
  - getModifiersExText
```
public static String getModifiersExText(int modifiers)
```
    返回一个描述扩展的修饰键和鼠标按钮的字符串，如“移”、“Button1”，或“Ctrl + Shift”。这些字符串可以通过改变 awt.properties文件本地化。
    请注意，传递的负参数是不正确的，并会导致返回一个未指定的字符串。零参数意味着没有通过的修饰语，并会导致返回一个空字符串。
    
    参数
    
    modifiers -改性剂的面具描述事件的扩展组合键和鼠标按钮
    
    结果
    
    在事件中被按住的扩展修改键键和鼠标键的组合的文本说明。
    
    从以下版本开始：
    
    一点四

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

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

Field Detail

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