InputEvent (Java 2 Platform SE 5.0) - JavaTM 2 Platform Standard Edition 5.0 API 规范中文版

概述

软件包

类

使用

树

已过时

索引

帮助

Java^TM 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
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

字段摘要
`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

概述