|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectjava.util.EventObject
java.awt.AWTEvent
java.awt.event.HierarchyEvent
public class HierarchyEvent
This class represents an event generated for an ancestor component which may affect this component. These events normally do not need to be handled by the application, since the AWT system automatically takes care of them.
There are two types of hierarchy events. The first type is handled by HierarchyListener, and includes addition or removal of an ancestor, or an ancestor changing its on-screen status (visible and/or displayble). The second type is handled by HierarchyBoundsListener, and includes resizing or moving of an ancestor.
HierarchyListener
,
HierarchyBoundsAdapter
,
HierarchyBoundsListener
,
Serialized FormField Summary | |
---|---|
static int |
ANCESTOR_MOVED
This id indicates that an ancestor was moved. |
static int |
ANCESTOR_RESIZED
This id indicates that an ancestor was resized. |
static int |
DISPLAYABILITY_CHANGED
This indicates that the HIERARCHY_CHANGED is caused by a change in displayability. |
static int |
HIERARCHY_CHANGED
This id indicates that the hierarchy tree changed. |
static int |
HIERARCHY_FIRST
This is the first id in the range of ids used by this class. |
static int |
HIERARCHY_LAST
This is the last id in the range of ids used by this class. |
static int |
PARENT_CHANGED
This indicates that the HIERARCHY_CHANGED is a changed parent. |
static int |
SHOWING_CHANGED
This indicates that the HIERARCHY_CHANGED is a changed visibility. |
Fields inherited from class java.util.EventObject |
---|
source |
Constructor Summary | |
---|---|
HierarchyEvent(Component source,
int id,
Component changed,
Container changedParent)
Initializes a new instance of HierarchyEvent with the
specified parameters. |
|
HierarchyEvent(Component source,
int id,
Component changed,
Container changedParent,
long changeFlags)
Initializes a new instance of HierarchyEvent with the
specified parameters. |
Method Summary | |
---|---|
Component |
getChanged()
Returns the component at the top of the hierarchy which changed. |
Container |
getChangedParent()
Returns the parent of the component listed in getChanged() . |
long |
getChangeFlags()
If this is a HIERARCHY_CHANGED event, this returns a bitmask of the types of changes that took place. |
Component |
getComponent()
This method returns the event source as a Component . |
String |
paramString()
This method returns a string identifying this event. |
Methods inherited from class java.awt.AWTEvent |
---|
consume, getID, isConsumed, setSource, toString |
Methods inherited from class java.util.EventObject |
---|
getSource |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
Field Detail |
---|
public static final int HIERARCHY_FIRST
public static final int HIERARCHY_CHANGED
public static final int ANCESTOR_MOVED
public static final int ANCESTOR_RESIZED
public static final int HIERARCHY_LAST
public static final int PARENT_CHANGED
public static final int DISPLAYABILITY_CHANGED
Component.isDisplayable()
,
Component.addNotify()
,
Component.removeNotify()
,
Constant Field Valuespublic static final int SHOWING_CHANGED
Component.isShowing()
,
Component.addNotify()
,
Component.removeNotify()
,
Component.show()
,
Component.hide()
,
Constant Field ValuesConstructor Detail |
---|
public HierarchyEvent(Component source, int id, Component changed, Container changedParent)
HierarchyEvent
with the
specified parameters. Note that an invalid id leads to unspecified
results.
source
- the component whose hierarchy changedid
- the event idchanged
- the top component in the tree of changed hierarchychangedParent
- the updated parent of this object
IllegalArgumentException
- if source is nullpublic HierarchyEvent(Component source, int id, Component changed, Container changedParent, long changeFlags)
HierarchyEvent
with the
specified parameters. Note that an invalid id leads to unspecified
results.
source
- the component whose hierarchy changedid
- the event idchanged
- the top component in the tree of changed hierarchychangedParent
- the updated parent of this objectchangeFlags
- the bitmask of specific HIERARCHY_CHANGED events
IllegalArgumentException
- if source is nullMethod Detail |
---|
public Component getComponent()
Component
. If the
source has subsequently been modified to a non-Component, this returns
null.
Component
, or nullpublic Component getChanged()
public Container getChangedParent()
getChanged()
.
If the cause of this event was Container.add
, this is the
new parent; if the cause was Container.remove
, this is the
old parent; otherwise it is the unchanged parent.
public long getChangeFlags()
PARENT_CHANGED
,
DISPLAYABILITY_CHANGED
,
SHOWING_CHANGED
public String paramString()
paramString
in class AWTEvent
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |