Class ComponentEvent
- All Implemented Interfaces:
Serializable
- Direct Known Subclasses:
ContainerEvent
,FocusEvent
,InputEvent
,PaintEvent
,WindowEvent
Component events are provided for notification purposes ONLY; The AWT will automatically handle component moves and resizes internally so that GUI layout works properly regardless of whether a program is receiving these events or not.
In addition to serving as the base class for other component-related events (InputEvent, FocusEvent, WindowEvent, ContainerEvent), this class defines the events that indicate changes in a component's size, position, or visibility.
This low-level event is generated by a component object (such as a
List) when the component is moved, resized, rendered invisible, or made
visible again. The event is passed to every ComponentListener
or ComponentAdapter
object which registered to receive such
events using the component's addComponentListener
method.
(ComponentAdapter
objects implement the
ComponentListener
interface.) Each such listener object
gets this ComponentEvent
when the event occurs.
An unspecified behavior will be caused if the id
parameter
of any particular ComponentEvent
instance is not
in the range from COMPONENT_FIRST
to COMPONENT_LAST
.
- Since:
- 1.1
- See Also:
-
Field Summary
Modifier and TypeFieldDescriptionstatic final int
The first number in the range of ids used for component events.static final int
This event indicates that the component was rendered invisible.static final int
The last number in the range of ids used for component events.static final int
This event indicates that the component's position changed.static final int
This event indicates that the component's size changed.static final int
This event indicates that the component was made visible.Fields inherited from 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 inherited from class java.util.EventObject
source
-
Constructor Summary
ConstructorDescriptionComponentEvent
(Component source, int id) Constructs aComponentEvent
object. -
Method Summary
Modifier and TypeMethodDescriptionReturns the originator of the event.Returns a parameter string identifying this event.Methods inherited from class java.util.EventObject
getSource
-
Field Details
-
COMPONENT_FIRST
public static final int COMPONENT_FIRSTThe first number in the range of ids used for component events.- See Also:
-
COMPONENT_LAST
public static final int COMPONENT_LASTThe last number in the range of ids used for component events.- See Also:
-
COMPONENT_MOVED
This event indicates that the component's position changed.- See Also:
-
COMPONENT_RESIZED
This event indicates that the component's size changed.- See Also:
-
COMPONENT_SHOWN
This event indicates that the component was made visible.- See Also:
-
COMPONENT_HIDDEN
This event indicates that the component was rendered invisible.- See Also:
-
-
Constructor Details
-
ComponentEvent
Constructs aComponentEvent
object.This method throws an
IllegalArgumentException
ifsource
isnull
.- Parameters:
source
- TheComponent
that originated the eventid
- An integer indicating the type of event. For information on allowable values, see the class description forComponentEvent
- Throws:
IllegalArgumentException
- ifsource
is null- See Also:
-
-
Method Details
-
getComponent
Returns the originator of the event.- Returns:
- the
Component
object that originated the event, ornull
if the object is not aComponent
.
-
paramString
Returns a parameter string identifying this event. This method is useful for event-logging and for debugging.- Overrides:
paramString
in classAWTEvent
- Returns:
- a string identifying the event and its attributes
-