Event (Java Platform SE 6) - JavaTM 2 Platform Standard Edition 6.0 API 规范中文版

对于键盘事件来说，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

字段摘要
`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 - 指定参数。