Module java.desktop

Package java.awt.event

Class 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）移动、调整大小、渲染不可见或再次可见时，将生成此低级事件。事件将传递给每个使用组件的addComponentListener方法注册接收此类事件的ComponentListener或ComponentAdapter对象。（ComponentAdapter对象实现ComponentListener接口。）每个此类监听器对象在事件发生时都会收到此ComponentEvent。

如果任何特定ComponentEvent实例的id参数不在COMPONENT_FIRST到COMPONENT_LAST范围内，将导致未指定的行为。

自 JDK 1.1 起:

1.1

参见:

• ComponentAdapter
• ComponentListener
• 教程: 编写组件监听器
• 序列化形式

Field Summary

Fields

Modifier and Type	Field	Description
static final int	COMPONENT_FIRST	用于组件事件的ID范围中的第一个数字。
static final int	COMPONENT_HIDDEN	此事件指示组件已渲染不可见。
static final int	COMPONENT_LAST	用于组件事件的ID范围中的最后一个数字。
static final int	COMPONENT_MOVED	此事件指示组件的位置已更改。
static final int	COMPONENT_RESIZED	此事件指示组件的大小已更改。
static final int	COMPONENT_SHOWN	此事件指示组件已变为可见。

Fields declared in class 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

Fields declared in class java.util.EventObject

source

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method	Description
Component	getComponent()	返回事件的发起者。
String	paramString()	返回标识此事件的参数字符串。

Methods declared in class java.awt.AWTEvent

consume, getID, isConsumed, setSource, toString

Methods declared in class java.util.EventObject

getSource

Methods declared in class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Details

COMPONENT_FIRST

             public static final int COMPONENT_FIRST
            

用于组件事件的ID范围中的第一个数字。

参见:

• 常量字段值

COMPONENT_LAST

             public static final int COMPONENT_LAST
            

用于组件事件的ID范围中的最后一个数字。

参见:

• 常量字段值

COMPONENT_MOVED

             @Native public static final int COMPONENT_MOVED
            

此事件指示组件的位置已更改。

参见:

• 常量字段值

COMPONENT_RESIZED

             @Native public static final int COMPONENT_RESIZED
            

此事件指示组件的大小已更改。

参见:

• 常量字段值

COMPONENT_SHOWN

             @Native public static final int COMPONENT_SHOWN
            

此事件指示组件已变为可见。

参见:

• 常量字段值

COMPONENT_HIDDEN

             @Native public static final int COMPONENT_HIDDEN
            

此事件指示组件已渲染不可见。

参见:

• 常量字段值

Constructor Details

ComponentEvent

             public ComponentEvent(Component source, int id)
            

构造一个ComponentEvent对象。

如果source为null，此方法将抛出IllegalArgumentException异常。

参数:

source - 产生事件的Component

id - 指示事件类型的整数。有关允许值的信息，请参阅ComponentEvent的类描述

抛出:

IllegalArgumentException - 如果source为null

参见:

• getComponent()
• AWTEvent.getID()

Method Details

getComponent

             public Component getComponent()
            

返回事件的发起者。

返回:

产生事件的Component对象，如果对象不是Component，则返回null。

paramString

             public String paramString()
            

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

覆盖:

paramString 在类 AWTEvent

返回:

标识事件及其属性的字符串