JavaTM 2 Platform
Standard Ed. 5.0

java.awt
类 AWTEvent

java.lang.Object
  继承者 java.util.EventObject
      继承者 java.awt.AWTEvent
所有已实现的接口:
Serializable
直接已知子类:
ActionEvent, AdjustmentEvent, AncestorEvent, ComponentEvent, HierarchyEvent, InputMethodEvent, InternalFrameEvent, InvocationEvent, ItemEvent, TextEvent

public abstract class AWTEvent
extends EventObject

所有 AWT 事件的根事件类。此类及其子类取代了原来的 java.awt.Event 类。此根 AWTEvent 类(在 java.awt.event 包的外部定义)的子类定义的事件 ID 值应该大于 RESERVED_ID_MAX 定义的值。

Component 子类需要此子类中定义的事件掩码,它使用 Component.enableEvents() 来选择未被已注册侦听器选择的事件类型。如果在一个组件上注册了侦听器,则该组件已经在内部设置了适当的事件掩码。

也使用该掩码来指定 AWTEventListener 应该侦听的事件类型。用按位或运算将该掩码集中起来,并传递给 Toolkit.addAWTEventListener。

从以下版本开始:
1.1
另请参见:
Component.enableEvents(long), Toolkit.addAWTEventListener(java.awt.event.AWTEventListener, long), ActionEvent, AdjustmentEvent, ComponentEvent, ContainerEvent, FocusEvent, InputMethodEvent, InvocationEvent, ItemEvent, HierarchyEvent, KeyEvent, MouseEvent, MouseWheelEvent, PaintEvent, TextEvent, WindowEvent, 序列化表格

字段摘要
static long ACTION_EVENT_MASK
          用于选择操作事件的事件掩码。
static long ADJUSTMENT_EVENT_MASK
          用于选择调整事件的事件掩码。
static long COMPONENT_EVENT_MASK
          用于选择组件事件的事件掩码。
protected  boolean consumed
          在源处理了事件之后,控制是否将事件发送回同位体,false 表示将事件发送给同位体;true 则不发送。
static long CONTAINER_EVENT_MASK
          用于选择容器事件的事件掩码。
static long FOCUS_EVENT_MASK
          用于选择焦点事件的事件掩码。
static long HIERARCHY_BOUNDS_EVENT_MASK
          用于选择层次结构边界事件的事件掩码。
static long HIERARCHY_EVENT_MASK
          用于选择层次结构事件的事件掩码。
protected  int id
          事件的 id。
static long INPUT_METHOD_EVENT_MASK
          用于选择输入方法事件的事件掩码。
static long INVOCATION_EVENT_MASK
          用于选择调用事件的事件掩码。
static long ITEM_EVENT_MASK
          用于选择项事件的事件掩码。
static long KEY_EVENT_MASK
          用于选择键事件的事件掩码。
static long MOUSE_EVENT_MASK
          用于选择鼠标事件的事件掩码。
static long MOUSE_MOTION_EVENT_MASK
          用于选择鼠标动作事件的事件掩码。
static long MOUSE_WHEEL_EVENT_MASK
          用于选择鼠标滚轮事件的事件掩码。
static long PAINT_EVENT_MASK
          用于选择绘制事件的事件掩码。
static int RESERVED_ID_MAX
          保留的 AWT 事件 ID 的最大值。
static long TEXT_EVENT_MASK
          用于选择文本事件的事件掩码。
static long WINDOW_EVENT_MASK
          用于选择窗口事件的事件掩码。
static long WINDOW_FOCUS_EVENT_MASK
          用于选择窗口焦点事件的事件掩码。
static long WINDOW_STATE_EVENT_MASK
          用于选择窗口状态事件的事件掩码。
 
从类 java.util.EventObject 继承的字段
source
 
构造方法摘要
AWTEvent(Event event)
          从 1.0 样式的事件参数构造一个 AWTEvent 对象。
AWTEvent(Object source, int id)
          使用指定的源对象和类型构造一个 AWTEvent 对象。
 
方法摘要
protected  void consume()
          如果能够使用此事件,则使用此事件。
 int getID()
          返回事件类型。
protected  boolean isConsumed()
          返回是否已经使用了此事件。
 String paramString()
          返回表示此 Event 状态的字符串。
 void setSource(Object newSource)
          将事件的目标更改为新的源。
 String toString()
          返回此对象的字符串表示形式。
 
从类 java.util.EventObject 继承的方法
getSource
 
从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

字段详细信息

id

protected int id
事件的 id。

另请参见:
getID(), AWTEvent(java.lang.Object, int)

consumed

protected boolean consumed
在源处理了事件之后,控制是否将事件发送回同位体,false 表示将事件发送给同位体;true 则不发送。语义事件始终具有 'true' 值,因为它们由响应低级别事件的同位体生成。

另请参见:
consume(), isConsumed()

COMPONENT_EVENT_MASK

public static final long COMPONENT_EVENT_MASK
用于选择组件事件的事件掩码。

另请参见:
常量字段值

CONTAINER_EVENT_MASK

public static final long CONTAINER_EVENT_MASK
用于选择容器事件的事件掩码。

另请参见:
常量字段值

FOCUS_EVENT_MASK

public static final long FOCUS_EVENT_MASK
用于选择焦点事件的事件掩码。

另请参见:
常量字段值

KEY_EVENT_MASK

public static final long KEY_EVENT_MASK
用于选择键事件的事件掩码。

另请参见:
常量字段值

MOUSE_EVENT_MASK

public static final long MOUSE_EVENT_MASK
用于选择鼠标事件的事件掩码。

另请参见:
常量字段值

MOUSE_MOTION_EVENT_MASK

public static final long MOUSE_MOTION_EVENT_MASK
用于选择鼠标动作事件的事件掩码。

另请参见:
常量字段值

WINDOW_EVENT_MASK

public static final long WINDOW_EVENT_MASK
用于选择窗口事件的事件掩码。

另请参见:
常量字段值

ACTION_EVENT_MASK

public static final long ACTION_EVENT_MASK
用于选择操作事件的事件掩码。

另请参见:
常量字段值

ADJUSTMENT_EVENT_MASK

public static final long ADJUSTMENT_EVENT_MASK
用于选择调整事件的事件掩码。

另请参见:
常量字段值

ITEM_EVENT_MASK

public static final long ITEM_EVENT_MASK
用于选择项事件的事件掩码。

另请参见:
常量字段值

TEXT_EVENT_MASK

public static final long TEXT_EVENT_MASK
用于选择文本事件的事件掩码。

另请参见:
常量字段值

INPUT_METHOD_EVENT_MASK

public static final long INPUT_METHOD_EVENT_MASK
用于选择输入方法事件的事件掩码。

另请参见:
常量字段值

PAINT_EVENT_MASK

public static final long PAINT_EVENT_MASK
用于选择绘制事件的事件掩码。

另请参见:
常量字段值

INVOCATION_EVENT_MASK

public static final long INVOCATION_EVENT_MASK
用于选择调用事件的事件掩码。

另请参见:
常量字段值

HIERARCHY_EVENT_MASK

public static final long HIERARCHY_EVENT_MASK
用于选择层次结构事件的事件掩码。

另请参见:
常量字段值

HIERARCHY_BOUNDS_EVENT_MASK

public static final long HIERARCHY_BOUNDS_EVENT_MASK
用于选择层次结构边界事件的事件掩码。

另请参见:
常量字段值

MOUSE_WHEEL_EVENT_MASK

public static final long MOUSE_WHEEL_EVENT_MASK
用于选择鼠标滚轮事件的事件掩码。

从以下版本开始:
1.4
另请参见:
常量字段值

WINDOW_STATE_EVENT_MASK

public static final long WINDOW_STATE_EVENT_MASK
用于选择窗口状态事件的事件掩码。

从以下版本开始:
1.4
另请参见:
常量字段值

WINDOW_FOCUS_EVENT_MASK

public static final long WINDOW_FOCUS_EVENT_MASK
用于选择窗口焦点事件的事件掩码。

从以下版本开始:
1.4
另请参见:
常量字段值

RESERVED_ID_MAX

public static final int RESERVED_ID_MAX
保留的 AWT 事件 ID 的最大值。定义自己的事件 ID 的程序应该使用大于此值的 ID。

另请参见:
常量字段值
构造方法详细信息

AWTEvent

public AWTEvent(Event event)
从 1.0 样式的事件参数构造一个 AWTEvent 对象。

参数:
event - 旧式的事件

AWTEvent

public AWTEvent(Object source,
                int id)
使用指定的源对象和类型构造一个 AWTEvent 对象。

参数:
source - 产生该事件的对象
方法详细信息

setSource

public void setSource(Object newSource)
将事件的目标更改为新的源。此方法通常用于将事件的目标更改为最初的重量级源的轻量级子组件。

只有事件目标子系统才能使用此方法,如客户机定义的 KeyboardFocusManager。一般的客户机不能使用。

参数:
newSource - 指派事件的新对象

getID

public int getID()
返回事件类型。


toString

public String toString()
返回此对象的字符串表示形式。

覆盖:
EventObject 中的 toString
返回:
该 EventObject 的 String 表示形式。

paramString

public String paramString()
返回表示此 Event 状态的字符串。此方法仅在进行调试的时候使用,返回的字符串的内容和格式也根据不同的实现而不同。返回的字符串可以为空,但不可以为 null

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

consume

protected void consume()
如果能够使用此事件,则使用此事件。只能使用低级别的系统事件。


isConsumed

protected boolean isConsumed()
返回是否已经使用了此事件。


JavaTM 2 Platform
Standard Ed. 5.0

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

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