- 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
FieldsModifier and TypeFieldDescriptionstatic final intThe first number in the range of ids used for component events.static final intThis event indicates that the component was rendered invisible.static final intThe last number in the range of ids used for component events.static final intThis event indicates that the component's position changed.static final intThis event indicates that the component's size changed.static final intThis event indicates that the component was made visible.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_MASKFields declared in class java.util.EventObject
source -
Constructor Summary
ConstructorsConstructorDescriptionComponentEvent(Component source, int id) Constructs aComponentEventobject. -
Method Summary
Modifier and TypeMethodDescriptionReturns the originator of the event.Returns a parameter string identifying this event.Methods declared in 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 aComponentEventobject.This method throws an
IllegalArgumentExceptionifsourceisnull.- Parameters:
source- TheComponentthat originated the eventid- An integer indicating the type of event. For information on allowable values, see the class description forComponentEvent- Throws:
IllegalArgumentException- ifsourceis null- See Also:
-
-
Method Details
-
getComponent
Returns the originator of the event.- Returns:
- the
Componentobject that originated the event, ornullif the object is not aComponent.
-
paramString
Returns a parameter string identifying this event. This method is useful for event-logging and for debugging.- Overrides:
paramStringin classAWTEvent- Returns:
- a string identifying the event and its attributes
-