Class AncestorEvent
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
FieldsModifier and TypeFieldDescriptionstatic final intAn ancestor-component was added to the hierarchy of visible objects (made visible), and is currently being displayed.static final intAn ancestor-component changed its position on the screen.static final intAn 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_MASKFields declared in class java.util.EventObject
source -
Constructor Summary
ConstructorsConstructorDescriptionAncestorEvent(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, toStringMethods 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_REMOVEDorANCESTOR_MOVEDancestor- 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
Containerobject 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
Containerobject specifying the ancestor's parent
-
getComponent
Returns the component that the listener was added to.- Returns:
- the
JComponenton which the event occurred
-