JavaTM 2 Platform
Standard Ed. 5.0

java.awt.event
类 ComponentEvent

java.lang.Object
  继承者 java.util.EventObject
      继承者 java.awt.AWTEvent
          继承者 java.awt.event.ComponentEvent
所有已实现的接口:
Serializable
直接已知子类:
ContainerEvent, FocusEvent, InputEvent, PaintEvent, WindowEvent

public class ComponentEvent
extends AWTEvent

指示组件被移动、大小被更改或可见性被更改的低级别事件(它也是其他组件级事件的根类)。

这些组件事件“仅”为通知目的而提供;AWT 将自动内部处理组件移动和调整大小,使 GUI 布局正常工作,而不管程序是否正接收这些事件。

除了充当其他组件相关事件(InputEvent、FocusEvent、WindowEvent 和 ContainerEvent)的基类之外,此类还定义了指示组件大小、位置或可见性方面的更改的事件。

当组件被移动、调整大小、呈现为不可见或再次可见时,此低级别事件由组件对象(比如 List)生成。事件被传递给每一个 ComponentListenerComponentAdapter 对象,这些对象已使用组件的 addComponentListener 方法注册,以接收这类事件。(ComponentAdapter 对象实现 ComponentListener 接口。)当发生该事件时,所有这类侦听器对象都获得此 ComponentEvent

从以下版本开始:
1.1
另请参见:
ComponentAdapter, ComponentListener, Tutorial: Writing a Component Listener, Reference: The Java Class Libraries (update file), 序列化表格

字段摘要
static int COMPONENT_FIRST
          用于组件事件的 id 范围的起始编号。
static int COMPONENT_HIDDEN
          此事件指示组件呈现为不可见。
static int COMPONENT_LAST
          用于组件事件的 id 范围的结束编号。
static int COMPONENT_MOVED
          此事件指示组件位置已更改。
static int COMPONENT_RESIZED
          此事件指示组件大小已更改。
static int COMPONENT_SHOWN
          此事件指示组件已变得可见。
 
从类 java.awt.AWTEvent 继承的字段
ACTION_EVENT_MASK, ADJUSTMENT_EVENT_MASK, COMPONENT_EVENT_MASK, consumed, CONTAINER_EVENT_MASK, FOCUS_EVENT_MASK, HIERARCHY_BOUNDS_EVENT_MASK, HIERARCHY_EVENT_MASK, id, INPUT_METHOD_EVENT_MASK, INVOCATION_EVENT_MASK, ITEM_EVENT_MASK, KEY_EVENT_MASK, MOUSE_EVENT_MASK, MOUSE_MOTION_EVENT_MASK, MOUSE_WHEEL_EVENT_MASK, PAINT_EVENT_MASK, RESERVED_ID_MAX, TEXT_EVENT_MASK, WINDOW_EVENT_MASK, WINDOW_FOCUS_EVENT_MASK, WINDOW_STATE_EVENT_MASK
 
从类 java.util.EventObject 继承的字段
source
 
构造方法摘要
ComponentEvent(Component source, int id)
          构造一个 ComponentEvent 对象。
 
方法摘要
 Component getComponent()
          返回事件的始发者。
 String paramString()
          返回标识此事件的参数字符串。
 
从类 java.awt.AWTEvent 继承的方法
consume, getID, isConsumed, setSource, toString
 
从类 java.util.EventObject 继承的方法
getSource
 
从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

字段详细信息

COMPONENT_FIRST

public static final int COMPONENT_FIRST
用于组件事件的 id 范围的起始编号。

另请参见:
常量字段值

COMPONENT_LAST

public static final int COMPONENT_LAST
用于组件事件的 id 范围的结束编号。

另请参见:
常量字段值

COMPONENT_MOVED

public static final int COMPONENT_MOVED
此事件指示组件位置已更改。

另请参见:
常量字段值

COMPONENT_RESIZED

public static final int COMPONENT_RESIZED
此事件指示组件大小已更改。

另请参见:
常量字段值

COMPONENT_SHOWN

public static final int COMPONENT_SHOWN
此事件指示组件已变得可见。

另请参见:
常量字段值

COMPONENT_HIDDEN

public static final int COMPONENT_HIDDEN
此事件指示组件呈现为不可见。

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

ComponentEvent

public ComponentEvent(Component source,
                      int id)
构造一个 ComponentEvent 对象。

注意,传入无效 id 会导致未指定的行为。如果 sourcenull,则此方法抛出 IllegalArgumentException

参数:
source - 发起事件的 Component
id - 指示事件类型的整数
抛出:
IllegalArgumentException - 如果 source 为 null
方法详细信息

getComponent

public Component getComponent()
返回事件的始发者。

返回:
发起事件的 Component 对象,如果该对象不是一个 Component,则返回 null

paramString

public String paramString()
返回标识此事件的参数字符串。此方法对于事件记录和调试很有用。

覆盖:
AWTEvent 中的 paramString
返回:
标识事件及其属性的字符串

JavaTM 2 Platform
Standard Ed. 5.0

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

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