java.lang.Object
java.util.EventObject
java.awt.AWTEvent
javax.swing.event.AncestorEvent
- All Implemented Interfaces:
Serializable
An event reported to a child component that originated from an
ancestor in the component hierarchy.
Warning:
Serialized objects of this class will not be compatible with
future Swing releases. The current serialization support is
appropriate for short term storage or RMI between applications running
the same version of Swing. As of 1.4, support for long term storage
of all JavaBeans
has been added to the java.beans
package.
Please see XMLEncoder
.
-
Field Summary
Modifier and TypeFieldDescriptionstatic final int
An ancestor-component was added to the hierarchy of visible objects (made visible), and is currently being displayed.static final int
An ancestor-component changed its position on the screen.static final int
An ancestor-component was removed from the hierarchy of visible objects (hidden) and is no longer being displayed.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
ConstructorDescriptionAncestorEvent
(JComponent source, int id, Container ancestor, Container ancestorParent) Constructs an AncestorEvent object to identify a change in an ancestor-component's display-status. -
Method Summary
Modifier and TypeMethodDescriptionReturns the ancestor that the event actually occurred on.Returns the parent of the ancestor the event actually occurred on.Returns the component that the listener was added to.Methods declared in class java.awt.AWTEvent
consume, getID, isConsumed, paramString, setSource, toString
Methods declared in class java.util.EventObject
getSource
-
Field Details
-
ANCESTOR_ADDED
public static final int ANCESTOR_ADDEDAn ancestor-component was added to the hierarchy of visible objects (made visible), and is currently being displayed.- See Also:
-
ANCESTOR_REMOVED
public static final int ANCESTOR_REMOVEDAn ancestor-component was removed from the hierarchy of visible objects (hidden) and is no longer being displayed.- See Also:
-
ANCESTOR_MOVED
public static final int ANCESTOR_MOVEDAn ancestor-component changed its position on the screen.- See Also:
-
-
Constructor Details
-
AncestorEvent
Constructs an AncestorEvent object to identify a change in an ancestor-component's display-status.- Parameters:
source
- the JComponent that originated the event (typicallythis
)id
- an int specifyingANCESTOR_ADDED
,ANCESTOR_REMOVED
orANCESTOR_MOVED
ancestor
- a Container object specifying the ancestor-component whose display-status changedancestorParent
- a Container object specifying the ancestor's parent
-
-
Method Details
-
getAncestor
Returns the ancestor that the event actually occurred on.- Returns:
- the
Container
object specifying the ancestor component
-
getAncestorParent
Returns the parent of the ancestor the event actually occurred on. This is most interesting in an ANCESTOR_REMOVED event, as the ancestor may no longer be in the component hierarchy.- Returns:
- the
Container
object specifying the ancestor's parent
-
getComponent
Returns the component that the listener was added to.- Returns:
- the
JComponent
on which the event occurred
-