java.awt
类 Event

java.lang.Object
  java.awt.Event

所有已实现的接口：

Serializable

public class Event
extends Object
implements Serializable

注：Event 类已废弃，只可用于向后兼容。它已经由 AWTEvent 类及其子类所取代。

Event 是一个与平台无关的类，它封装了 Java 1.0 事件模型中来自平台图形用户界面的事件。在 Java 1.1 和以后的版本中，Event 类只针对向后兼容进行维护。此类描述中的信息可以协助程序员将 Java 1.0 程序转换成新的事件模型。

在 Java 1.0 事件模型中，包含 id 字段的事件指出它是什么类型的事件，以及与该事件有关的其他 Event 变量。

对于键盘事件来说，key 所包含的值指出要激活哪个键，modifiers 包含该事件的修饰符。对于 KEY_PRESS 和 KEY_RELEASE 事件的 id，key 的值是该键的 unicode 字符代码。对于 KEY_ACTION 和 KEY_ACTION_RELEASE，key 的值是 Event 类（PGUP、PGDN、F1、F2 等）中所定义的某个动作-键标识符。

从以下版本开始：

JDK1.0

另请参见：

序列化表格

字段摘要

static int	ACTION_EVENT 此事件指示用户想要某个事件发生。
static int	ALT_MASK 此标志指示当事件发生时按下 Alt 键。
Object	arg 事件的任意参数。
static int	BACK_SPACE BackSpace 键。
static int	CAPS_LOCK Caps Lock 键，一个非 ASCII 操作键。
int	clickCount 对于 MOUSE_DOWN 事件来说，此字段指示连续点击的次数。
static int	CTRL_MASK 此标志指示当事件发生时按下 Control 键。
static int	DELETE Delete 键。
static int	DOWN Down Arrow 键，一个非 ASCII 操作键。
static int	END End 键，一个非 ASCII 操作键。
static int	ENTER Enter 键。
static int	ESCAPE Escape 键。
Event	evt 下一事件。
static int	F1 F1 功能键，一个非 ASCII 操作键。
static int	F10 F10 功能键，一个非 ASCII 操作键。
static int	F11 F11 功能键，一个非 ASCII 操作键。
static int	F12 F12 功能键，一个非 ASCII 操作键。
static int	F2 F2 功能键，一个非 ASCII 操作键。
static int	F3 F3 功能键，一个非 ASCII 操作键。
static int	F4 F4 功能键，一个非 ASCII 操作键。
static int	F5 F5 功能键，一个非 ASCII 操作键。
static int	F6 F6 功能键，一个非 ASCII 操作键。
static int	F7 F7 功能键，一个非 ASCII 操作键。
static int	F8 F8 功能键，一个非 ASCII 操作键。
static int	F9 F9 功能键，一个非 ASCII 操作键。
static int	GOT_FOCUS 组件获得焦点。
static int	HOME Home 键，一个非 ASCII 操作键。
int	id 指示事件是什么类型的事件，其他哪个 Event 变量与该事件有关。
static int	INSERT Insert 键，一个非 ASCII 操作键。
int	key 在键盘事件中被按下的键的键代码。
static int	KEY_ACTION 用户已经按下一个非 ASCII action 键。
static int	KEY_ACTION_RELEASE 用户已经释放一个非 ASCII action 键。
static int	KEY_PRESS 用户已经按下一个常规键。
static int	KEY_RELEASE 用户已经释放一个常规键。
static int	LEFT Left Arrow 键，一个非 ASCII 操作键。
static int	LIST_DESELECT 已经取消选择列表中的一项。
static int	LIST_SELECT 已经选择了列表中的一项。
static int	LOAD_FILE 文件加载事件。
static int	LOST_FOCUS 组件失去焦点。
static int	META_MASK 此标志指示当事件发生时按下 Meta 键。
int	modifiers 修饰符键的状态。
static int	MOUSE_DOWN 用户已经按下鼠标按钮。
static int	MOUSE_DRAG 鼠标已经移动，同时按钮被按下。
static int	MOUSE_ENTER 鼠标已经进入了一个组件。
static int	MOUSE_EXIT 鼠标已经退出了一个组件。
static int	MOUSE_MOVE 鼠标已经移动，没有按钮被按下。
static int	MOUSE_UP 用户已经释放鼠标按钮。
static int	NUM_LOCK Num Lock 键，一个非 ASCII 操作键。
static int	PAUSE Pause 键，一个非 ASCII 操作键。
static int	PGDN Page Down 键，一个非 ASCII 操作键。
static int	PGUP Page Up 键，一个非 ASCII 操作键。
static int	PRINT_SCREEN Print Screen 键，一个非 ASCII 操作键。
static int	RIGHT Right Arrow 键，一个非 ASCII 操作键。
static int	SAVE_FILE 文件保存事件。
static int	SCROLL_ABSOLUTE 用户已经将滚动条中的“气泡”（即翻阅标志）移到一个“绝对的”位置，而不是相对最后位置的偏移量。
static int	SCROLL_BEGIN 滚动开始事件。
static int	SCROLL_END 滚动结束事件。
static int	SCROLL_LINE_DOWN 用户已经激活了滚动条的 line down 区域。
static int	SCROLL_LINE_UP 用户已经激活了滚动条的 line up 区域。
static int	SCROLL_LOCK Scroll Lock 键，一个非 ASCII 操作键。
static int	SCROLL_PAGE_DOWN 用户已经激活了滚动条的 page down 区域。
static int	SCROLL_PAGE_UP 用户已经激活了滚动条的 page up 区域。
static int	SHIFT_MASK 此标志指示当事件发生时按下 Shift 键。
static int	TAB Tab 键。
Object	target 目标组件。
static int	UP Up Arrow 键，一个非 ASCII 操作键。
long	when 时间戳。
static int	WINDOW_DEICONIFY 用户要求窗口管理程序取消窗口图标化。
static int	WINDOW_DESTROY 用户要求窗口管理程序关掉窗口。
static int	WINDOW_EXPOSE 用户要求窗口管理程序公开窗口。
static int	WINDOW_ICONIFY 用户要求窗口管理程序图标化窗口。
static int	WINDOW_MOVED 用户要求窗口管理程序移动窗口。
int	x 事件的 x 坐标。
int	y 事件的 y 坐标。

构造方法摘要

Event(Object target, int id, Object arg)
注：Event 类已废弃，只可用于向后兼容。

Event(Object target, long when, int id, int x, int y, int key, int modifiers)
注：Event 类已废弃，只可用于向后兼容。

Event(Object target, long when, int id, int x, int y, int key, int modifiers, Object arg)
注：Event 类已废弃，只可用于向后兼容。

方法摘要

boolean	controlDown() 注：Event 类已废弃，只可用于向后兼容。
boolean	metaDown() 注：Event 类已废弃，只可用于向后兼容。
protected String	paramString() 注：Event 类已废弃，只可用于向后兼容。
boolean	shiftDown() 注：Event 类已废弃，只可用于向后兼容。
String	toString() 注：Event 类已废弃，只可用于向后兼容。
void	translate(int dx, int dy) 注：Event 类已废弃，只可用于向后兼容。

从类 java.lang.Object 继承的方法

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

字段详细信息

SHIFT_MASK

public static final int SHIFT_MASK

此标志指示当事件发生时按下 Shift 键。

另请参见：

常量字段值

CTRL_MASK

public static final int CTRL_MASK

此标志指示当事件发生时按下 Control 键。

另请参见：

常量字段值

META_MASK

public static final int META_MASK

此标志指示当事件发生时按下 Meta 键。对于鼠标事件，此标志指示按下或释放右边按钮。

另请参见：

常量字段值

ALT_MASK

public static final int ALT_MASK

此标志指示当事件发生时按下 Alt 键。对于鼠标事件，此标志指示按下或释放中间鼠标按钮。

另请参见：

常量字段值

HOME

public static final int HOME

Home 键，一个非 ASCII 操作键。

另请参见：

常量字段值

END

public static final int END

End 键，一个非 ASCII 操作键。

另请参见：

常量字段值

PGUP

public static final int PGUP

Page Up 键，一个非 ASCII 操作键。

另请参见：

常量字段值

PGDN

public static final int PGDN

Page Down 键，一个非 ASCII 操作键。

另请参见：

常量字段值

UP

public static final int UP

Up Arrow 键，一个非 ASCII 操作键。

另请参见：

常量字段值

DOWN

public static final int DOWN

Down Arrow 键，一个非 ASCII 操作键。

另请参见：

常量字段值

LEFT

public static final int LEFT

Left Arrow 键，一个非 ASCII 操作键。

另请参见：

常量字段值

RIGHT

public static final int RIGHT

Right Arrow 键，一个非 ASCII 操作键。

另请参见：

常量字段值

F1

public static final int F1

F1 功能键，一个非 ASCII 操作键。

另请参见：

常量字段值

F2

public static final int F2

F2 功能键，一个非 ASCII 操作键。

另请参见：

常量字段值

F3

public static final int F3

F3 功能键，一个非 ASCII 操作键。

另请参见：

常量字段值

F4

public static final int F4

F4 功能键，一个非 ASCII 操作键。

另请参见：

常量字段值

F5

public static final int F5

F5 功能键，一个非 ASCII 操作键。

另请参见：

常量字段值

F6

public static final int F6

F6 功能键，一个非 ASCII 操作键。

另请参见：

常量字段值

F7

public static final int F7

F7 功能键，一个非 ASCII 操作键。

另请参见：

常量字段值

F8

public static final int F8

F8 功能键，一个非 ASCII 操作键。

另请参见：

常量字段值

F9

public static final int F9

F9 功能键，一个非 ASCII 操作键。

另请参见：

常量字段值

F10

public static final int F10

F10 功能键，一个非 ASCII 操作键。

另请参见：

常量字段值

F11

public static final int F11

F11 功能键，一个非 ASCII 操作键。

另请参见：

常量字段值

F12

public static final int F12

F12 功能键，一个非 ASCII 操作键。

另请参见：

常量字段值

PRINT_SCREEN

public static final int PRINT_SCREEN

Print Screen 键，一个非 ASCII 操作键。

另请参见：

常量字段值

SCROLL_LOCK

public static final int SCROLL_LOCK

Scroll Lock 键，一个非 ASCII 操作键。

另请参见：

常量字段值

CAPS_LOCK

public static final int CAPS_LOCK

Caps Lock 键，一个非 ASCII 操作键。

另请参见：

常量字段值

NUM_LOCK

public static final int NUM_LOCK

Num Lock 键，一个非 ASCII 操作键。

另请参见：

常量字段值

PAUSE

public static final int PAUSE

Pause 键，一个非 ASCII 操作键。

另请参见：

常量字段值

INSERT

public static final int INSERT

Insert 键，一个非 ASCII 操作键。

另请参见：

常量字段值

ENTER

public static final int ENTER

Enter 键。

另请参见：

常量字段值

BACK_SPACE

public static final int BACK_SPACE

BackSpace 键。

另请参见：

常量字段值

TAB

public static final int TAB

Tab 键。

另请参见：

常量字段值

ESCAPE

public static final int ESCAPE

Escape 键。

另请参见：

常量字段值

DELETE

public static final int DELETE

Delete 键。

另请参见：

常量字段值

WINDOW_DESTROY

public static final int WINDOW_DESTROY

用户要求窗口管理程序关掉窗口。

另请参见：

常量字段值

WINDOW_EXPOSE

public static final int WINDOW_EXPOSE

用户要求窗口管理程序公开窗口。

另请参见：

常量字段值

WINDOW_ICONIFY

public static final int WINDOW_ICONIFY

用户要求窗口管理程序图标化窗口。

另请参见：

常量字段值

WINDOW_DEICONIFY

public static final int WINDOW_DEICONIFY

用户要求窗口管理程序取消窗口图标化。

另请参见：

常量字段值

WINDOW_MOVED

public static final int WINDOW_MOVED

用户要求窗口管理程序移动窗口。

另请参见：

常量字段值

KEY_PRESS

public static final int KEY_PRESS

用户已经按下一个常规键。

另请参见：

常量字段值

KEY_RELEASE

public static final int KEY_RELEASE

用户已经释放一个常规键。

另请参见：

常量字段值

KEY_ACTION

public static final int KEY_ACTION

用户已经按下一个非 ASCII action 键。key 字段包含一个值，指示发生在某个操作键上的事件，操作键包括 12 个功能键、箭头（光标）键、Page Up、Page Down、Home、End、Print Screen、Scroll Lock、Caps Lock、Num Lock、Pause 和 Insert。

另请参见：

常量字段值

KEY_ACTION_RELEASE

public static final int KEY_ACTION_RELEASE

用户已经释放一个非 ASCII action 键。key 字段包含一个值，指示发生在某个操作键中的事件，操作键包括 12 个功能键、箭头（光标）键、Page Up、Page Down、Home、End、Print Screen、Scroll Lock、Caps Lock、Num Lock、Pause 和 Insert。

另请参见：

常量字段值

MOUSE_DOWN

public static final int MOUSE_DOWN

用户已经按下鼠标按钮。ALT_MASK 标志指示中间按钮已经被按下。META_MASK 标志指示右按钮已经被按下。

另请参见：

ALT_MASK, META_MASK, 常量字段值

MOUSE_UP

public static final int MOUSE_UP

用户已经释放鼠标按钮。ALT_MASK 标志指示中间按钮已经被释放。META_MASK 标志指示右边按钮已经被释放。

另请参见：

ALT_MASK, META_MASK, 常量字段值

MOUSE_MOVE

public static final int MOUSE_MOVE

鼠标已经移动，没有按钮被按下。

另请参见：

常量字段值

MOUSE_ENTER

public static final int MOUSE_ENTER

鼠标已经进入了一个组件。

另请参见：

常量字段值

MOUSE_EXIT

public static final int MOUSE_EXIT

鼠标已经退出了一个组件。

另请参见：

常量字段值

MOUSE_DRAG

public static final int MOUSE_DRAG

鼠标已经移动，同时按钮被按下。ALT_MASK 标志指示中间按钮正在被按下。META_MASK 标志指示右边按钮正在被按下。

另请参见：

ALT_MASK, META_MASK, 常量字段值

SCROLL_LINE_UP

public static final int SCROLL_LINE_UP

用户已经激活了滚动条的 line up 区域。

另请参见：

常量字段值

SCROLL_LINE_DOWN

public static final int SCROLL_LINE_DOWN

用户已经激活了滚动条的 line down 区域。

另请参见：

常量字段值

SCROLL_PAGE_UP

public static final int SCROLL_PAGE_UP

用户已经激活了滚动条的 page up 区域。

另请参见：

常量字段值

SCROLL_PAGE_DOWN

public static final int SCROLL_PAGE_DOWN

用户已经激活了滚动条的 page down 区域。

另请参见：

常量字段值

SCROLL_ABSOLUTE

public static final int SCROLL_ABSOLUTE

用户已经将滚动条中的“气泡”（即翻阅标志）移到一个“绝对的”位置，而不是相对最后位置的偏移量。

另请参见：

常量字段值

SCROLL_BEGIN

public static final int SCROLL_BEGIN

滚动开始事件。

另请参见：

常量字段值

SCROLL_END

public static final int SCROLL_END

滚动结束事件。

另请参见：

常量字段值

LIST_SELECT

public static final int LIST_SELECT

已经选择了列表中的一项。

另请参见：

常量字段值

LIST_DESELECT

public static final int LIST_DESELECT

已经取消选择列表中的一项。

另请参见：

常量字段值

ACTION_EVENT

public static final int ACTION_EVENT

此事件指示用户想要某个事件发生。

另请参见：

常量字段值

LOAD_FILE

public static final int LOAD_FILE

文件加载事件。

另请参见：

常量字段值

SAVE_FILE

public static final int SAVE_FILE

文件保存事件。

另请参见：

常量字段值

GOT_FOCUS

public static final int GOT_FOCUS

组件获得焦点。

另请参见：

常量字段值

LOST_FOCUS

public static final int LOST_FOCUS

组件失去焦点。

另请参见：

常量字段值

target

public Object target

目标组件。这指示事件针对该组件发生，或事件与该组件关联。此对象已经由 AWTEvent.getSource() 取代。

另请参见：

EventObject.getSource()

when

public long when

时间戳。由 InputEvent.getWhen() 取代。

另请参见：

InputEvent.getWhen()

id

public int id

指示事件是什么类型的事件，其他哪个 Event 变量与该事件有关。它已经由 AWTEvent.getID() 取代。

另请参见：

AWTEvent.getID()

x

public int x

事件的 x 坐标。由 MouseEvent.getX() 取代。

另请参见：

MouseEvent.getX()

y

public int y

事件的 y 坐标。由 MouseEvent.getY() 取代。

另请参见：

MouseEvent.getY()

key

public int key

在键盘事件中被按下的键的键代码。这已经由 KeyEvent.getKeyCode() 取代。

另请参见：

KeyEvent.getKeyCode()

modifiers

public int modifiers

修饰符键的状态。这已经由 InputEvent.getModifiers() 取代。在 java 1.1 中，MouseEvent 和 KeyEvent 是 InputEvent 的子类。

另请参见：

InputEvent.getModifiers()

clickCount

public int clickCount

对于 MOUSE_DOWN 事件来说，此字段指示连续点击的次数。对于其他事件，其值为 0。此字段由 MouseEvent.getClickCount() 取代。

另请参见：

MouseEvent.getClickCount().

arg

public Object arg

事件的任意参数。此字段的值取决于事件的类型。arg 已经由事件指定的属性取代。

evt

public Event evt

下一事件。将事件放入到链接列表时设置此字段。这已经由 EventQueue 取代。

另请参见：

EventQueue

构造方法详细信息

Event

public Event(Object target,
             long when,
             int id,
             int x,
             int y,
             int key,
             int modifiers,
             Object arg)

注：Event 类已废弃，只可用于向后兼容。它已经由 AWTEvent 类及其子类所取代。

创建 Event 的一个实例，具有指定的目标组件、时间戳、事件类型、x 和 y 坐标、键盘键、修饰符键的状态、参数。

参数：

target - 目标组件。

when - 时间戳。

id - 事件类型。

x - x 坐标。

y - y 坐标。

key - 在键盘事件中按下的键。

modifiers - 修饰符键的状态。

arg - 指定参数。

Event

public Event(Object target,
             long when,
             int id,
             int x,
             int y,
             int key,
             int modifiers)

注：Event 类已废弃，只可用于向后兼容。它已经由 AWTEvent 类和其子类所取代。

创建 Event 的一个实例，具有指定的目标组件、时间戳、事件类型、x 和 y 坐标、键盘键、修饰符键的状态、一个设置为 null 的参数。

参数：

target - 目标组件。

when - 时间戳。

id - 事件类型。

x - x 坐标。

y - y 坐标。

key - 在键盘事件中按下的键。

modifiers - 修饰符键的状态。

Event

public Event(Object target,
             int id,
             Object arg)

注：Event 类已废弃，只可用于向后兼容。它已经由 AWTEvent 类和其子类所取代。

使用指定的目标组件、事件类型和参数创建 Event 的一个实例。

参数：

target - 目标组件。

id - 事件类型。

arg - 指定参数。

方法详细信息

translate

public void translate(int dx,
                      int dy)

注：Event 类已废弃，只可用于向后兼容。它已经由 AWTEvent 类和其子类所取代。

转换此事件，使其 x 和 y 坐标分别以 dx 和 dy 递增。

此方法转换与给定组件相关的事件。这至少涉及到将坐标转换成给定组件的本地坐标系。它还可能涉及到在公开事件中转换一个区域

参数：

dx - 要转换 x 坐标的距离。

dy - 要转换 y 坐标的距离。

shiftDown

public boolean shiftDown()

注：Event 类已废弃，只可用于向后兼容。它已经由 AWTEvent 类和其子类所取代。

检查 Shift 键是否被按下。

返回：

如果该键被按下，则返回 true；否则返回 false。

另请参见：

modifiers, controlDown(), metaDown()

controlDown

public boolean controlDown()

注：Event 类已废弃，只可用于向后兼容。它已经由 AWTEvent 类和其子类所取代。

检查 Control 键是否被按下。

返回：

如果该键被按下，则返回 true；否则返回 false。

另请参见：

modifiers, shiftDown(), metaDown()

metaDown

public boolean metaDown()

注：Event 类已废弃，只可用于向后兼容。它已经由 AWTEvent 类和其子类所取代。

检查 Meta 键是否被按下。

返回：

如果该键被按下，则返回 true；否则返回 false。

另请参见：

modifiers, shiftDown(), controlDown()

paramString

protected String paramString()

注：Event 类已废弃，只可用于向后兼容。它已经由 AWTEvent 类和其子类所取代。

返回此 Event 状态的字符串表示形式。此方法仅用于调试目的，对于这两种实现，返回字符串的内容和格式可能有所不同。返回的字符串可能为空，但不可能为 null。

返回：

此事件的参数字符串

toString

public String toString()

注：Event 类已废弃，只可用于向后兼容。它已经由 AWTEvent 类和其子类所取代。

返回此事件的值的字符串表示形式。

覆盖：

类 Object 中的 toString

返回：

字符串，表示事件及其成员字段的值。

从以下版本开始：

JDK1.1

另请参见：

paramString()