JavaTM Platform
Standard Ed. 6

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 类(PGUPPGDNF1F2 等)中所定义的某个动作-键标识符。

从以下版本开始:
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 的一个实例,具有指定的目标组件、时间戳、事件类型、xy 坐标、键盘键、修饰符键的状态、参数。

参数:
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 的一个实例,具有指定的目标组件、时间戳、事件类型、xy 坐标、键盘键、修饰符键的状态、一个设置为 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 类和其子类所取代。

转换此事件,使其 xy 坐标分别以 dxdy 递增。

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

参数:
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()

JavaTM Platform
Standard Ed. 6

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

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