类 java.awt.Event

java.lang.Object
   |
   +----java.awt.Event

public class Event
extends Object
implements Serializable

Event 是一个与平台独立的类，在 Java 1.0 事件模型中其封装了从平台的 GUI 中的事件。在 Java 1.1 和其后的版本中，为了向下兼容仍然保留 Event 类。该类的说明信息是为了帮助程序员将 Java 1.0 程序转换到新事件模型而提供的。

在 Java 1.0 的事件模型中，一个事件包含一个 id 域，用来表示它的事件类型，和哪个 Event 变量与该事件有关。

对于键盘事件，key 包含表示哪个键是活动的值，同时 modifiers 包含那个事件的修饰词。对于 KEY_PRESS 和 KEY_RELEASE 的事件标识符， key 的值是该键的 unicode 字符代码。对于 KEY_ACTION 和 KEY_ACTION_RELEASE， key 值是在? Event 类中定义的一个 action-key 标识符 (PGUP， PGDN， F1， F2，等)。

变量索引

ACTION_EVENT: 该事件表示请求某个动作的发生。
ALT_MASK: 该标志表示当事件发生时 Alt 键是按下的。
arg: 事件的一个任意参数。
BACK_SPACE: BackSpace 键。
CAPS_LOCK: Caps Lock 键，非 ASCII 动作键。
clickCount: 对于 MOUSE_DOWN 事件，该域表示连续单击的次数。
CTRL_MASK: 该标志表示当事件发生时 Control 键是按下的。
DELETE: Delete 键。
DOWN: Down Arrow 键，非 ASCII 动作键。
END: End 键，非 ASCII 动作键。
ENTER: Enter 键。
ESCAPE: Escape 键。
evt: 下一个事件。
F1: F1 功能键，非 ASCII 动作键。
F10: F10 功能键，非 ASCII 动作键。
F11: F11 功能键，非 ASCII 动作键。
F12: F12 功能键，非 ASCII 动作键。
F2: F2 功能键，非 ASCII 动作键。
F3: F3 功能键，非 ASCII 动作键。
F4: F4 功能键，非 ASCII 动作键。
F5: F5 功能键，非 ASCII 动作键。
F6: F6 功能键，非 ASCII 动作键。
F7: F7 功能键，非 ASCII 动作键。
F8: F8 功能键，非 ASCII 动作键。
F9: F9 功能键，非 ASCII 动作键。
GOT_FOCUS: 一个获取焦点的组件。
HOME: Home 键，非 ASCII 动作键。
id: 表示事件的类型，和其他与事件有关的 Event 变量。
INSERT: Insert 键，非 ASCII 动作键。
key: 在键盘事件中被按下键的键代码。
KEY_ACTION: 用户已经按下一个非 ASCII动作键。
KEY_ACTION_RELEASE: 用户已经释放一个非 ASCII动作键。
KEY_PRESS: 用户已经按下一个普通键。
KEY_RELEASE: 用户已经释放一个普通键。
LEFT: Left Arrow 键，非 ASCII 动作键。
LIST_DESELECT: 列表中的一个项目已经取消选择。
LIST_SELECT: 列表中的一个项目已经被选定。
LOAD_FILE: 一个正在装入文件的事件。
LOST_FOCUS: 一个丢失焦点的组件。
META_MASK: 该标志表示当事件发生时 Meta 键是按下的。
modifiers: 修改关键字的状态。
MOUSE_DOWN: 用户已经按下鼠标按钮。
MOUSE_DRAG: 用户已按下鼠标按钮并移动鼠标。
MOUSE_ENTER: 鼠标移入一个组件。
MOUSE_EXIT: 鼠标移出一个组件。
MOUSE_MOVE: 鼠标在移动并且没有按钮被按下。
MOUSE_UP: 用户释放了鼠标按钮。
NUM_LOCK: Num Lock 键，非 ASCII 动作键。
PAUSE: Pause 键，非 ASCII 动作键。
PGDN: Page Down 键，非 ASCII 动作键。
PGUP: Page Up 键，非 ASCII 动作键。
PRINT_SCREEN: Print Screen 键，非 ASCII 动作键。
RIGHT: Right Arrow 键，非 ASCII 动作键。
SAVE_FILE: 文件保存事件。
SCROLL_ABSOLUTE: 用户移动了滚动条上的气泡(滑杆)，移动到一个“绝对”位置，而不是相对于上次位置的偏移。
SCROLL_BEGIN: 滚动开始事件。
SCROLL_END: 滚动终止事件。
SCROLL_LINE_DOWN: 用户激活了滚动条上的 line down 区域。
SCROLL_LINE_UP: 用户激活了滚动条上的 line up 区域。
SCROLL_LOCK: Scroll Lock 键，非 ASCII 动作键。
SCROLL_PAGE_DOWN: 用户激活了滚动条上的 page down 区域。
SCROLL_PAGE_UP: 用户激活了滚动条上的 page up 区域。
SHIFT_MASK: 该标志表示当事件发生时 Shift 键是按下的。
TAB: Tab 键。
target: 目标组件。
UP: Up Arrow 键，非 ASCII 动作键。
when: 时间标记。
WINDOW_DEICONIFY: 用户请求窗口管理程序非图标化窗口。
WINDOW_DESTROY: 用户请求窗口管理程序终止窗口。
WINDOW_EXPOSE: 用户请求窗口管理程序显示窗口。
WINDOW_ICONIFY: 用户请求窗口管理程序图标化窗口。
WINDOW_MOVED: 用户请求窗口管理程序移动窗口。
x: 事件的 x 坐标。
y: 事件的 y 坐标。

构造子索引

Event(Object, int, Object): 使用指定的目标组件、事件类型和参数来创建一个 Event 实例。
Event(Object, long, int, int, int, int, int): 创建一个 Event 实例带有指定的目标组件、时间标记、事件类型、 x 和 y 坐标、键盘的键、修改关键字的状态和一个设置为 null 的参数。
Event(Object, long, int, int, int, int, int, Object): 使用指定的目标组件、时间标记、事件类型、 x 和 y 坐标、键盘的键、修改关键字的状态和一个设置为 null 的参数来创建一个 Event 实例。

方法索引

controlDown(): 检查 Control 键是否按下。
metaDown(): 检查 Meta 键是否按下。
paramString(): 返回代表该事件的参数字符串。
shiftDown(): 检查 Shift 键是否按下。
toString(): 用一个字符串返回该事件数值的表示法。
translate(int, int): 分别使用 dx 和 dy 来增加它的 x 和 y 坐标来平移该事件。

变量

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 动作键。

 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 动作键。

 public static final int F1

F1 功能键，非 ASCII 动作键。

 public static final int F2

F2 功能键，非 ASCII 动作键。

 public static final int F3

F3 功能键，非 ASCII 动作键。

 public static final int F4

F4 功能键，非 ASCII 动作键。

 public static final int F5

F5 功能键，非 ASCII 动作键。

 public static final int F6

F6 功能键，非 ASCII 动作键。

 public static final int F7

F7 功能键，非 ASCII 动作键。

 public static final int F8

F8 功能键，非 ASCII 动作键。

 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 动作键。 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 动作键。 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 标志表示鼠标中键被按下。 ALT_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 标志表示出鼠标中键被按下。 ALT_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

目标组件。它用于表示事件发生在哪个组件上或事件与哪个组件相联系。

when

 public long when

时间标记。

 public int id

表示事件的类型，和其他与事件有关的 Event 变量。

 public int x

事件的 x 坐标。

 public int y

事件的 y 坐标。

key

 public int key

在键盘事件中用于表示键被按下的键代码。

modifiers

 public int modifiers

修改关键字的状态。

注意：不推荐改变修改关键字，因为许多本地的工具不能识别修饰词的改变。特别是在 shift 修饰词改变了的地方。

clickCount

 public int clickCount

对于 MOUSE_DOWN 事件，该域表示连续单击的次数。对于其他事件，它的值为 0 。

arg

 public Object arg

事件的一个任意参数。该域的数值取决于事件的类型。

evt

 public Event evt

下一个事件。当将事件放入链接表时该域被设置。

构造子

Event

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

使用指定的目标组件、时间标记、事件类型、 x 和 y 坐标、键盘的键、修改关键字的状态和参数来创建一个 Event 实例。

参数：: 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 实例, 带有指定的目标组件、时间标记、事件类型、 x 和 y 坐标、键盘的键、修改关键字的状态和一个设置为 null 的参数。

参数：: target - 目标组件。; when - 时间标记。; id - 事件类型。; x - x 坐标。; y - y 坐标。; key - 在键盘事件中按下的键。; modifiers - 修改关键字的状态。

Event

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

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

参数：: target - 目标组件。; id - 事件类型。; arg - 指定的参数。

方法

translate

 public void translate(int x,
                       int y)

分别使用 dx 和 dy 来增加它的 x 和 y 坐标来平移该事件。

该方法平移与指定组件相关事件。这包括，至少将坐标平移到指定组件的局部坐标系中。它也包括在显示事件情况下的平移区域。

参数：: dx - 平移的 x 坐标距离。; dy - 平移的 y 坐标距离。

shiftDown

 public boolean shiftDown()

检查 Shift 键是否按下。

返回值：: 如果键是按下的为 true ；否则为 false 。
参见：: modifiers, controlDown, metaDown

controlDown

 public boolean controlDown()

检查 Control 键是否按下。

返回值：: 如果键是按下的为 true ；否则为 false 。
参见：: modifiers, shiftDown, metaDown

metaDown

 public boolean metaDown()

检查 Meta 键是否按下。

返回值：: 如果键是按下的为 true ；否则为 false 。
参见：: modifiers, shiftDown, controlDown

paramString

 protected String paramString()

返回代表该事件的参数字符串。该字符串对调试有用。

返回值：: 该事件的参数字符串。

toString

 public String toString()

用一个字符串返回该事件数值的表示法。

返回值：: 代表事件和它的成员域数值的字符串。
覆盖：: 类 Object 中的 toString
参见：: paramString

当前位置类层次 (JDK) 所有类 (JDK) 所有域和方法 (JDK)