JavaTM 2 Platform
Standard Ed. 5.0

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

JavaTM 2 Platform
Standard Ed. 5.0

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策