Class HierarchyEvent

public static final int ANCESTOR_MOVED

This id indicates that an ancestor was moved.

Field Value:

1401

public static final int ANCESTOR_RESIZED

This id indicates that an ancestor was resized.

Field Value:

1402

public static final int DISPLAYABILITY_CHANGED

This indicates that the HIERARCHY_CHANGED is caused by a change in displayability.

Field Value:

2

See Also:

Component.isDisplayable(), Component.addNotify(), Component.removeNotify()

public static final int HIERARCHY_CHANGED

This id indicates that the hierarchy tree changed.

Field Value:

1400

public static final int HIERARCHY_FIRST

This is the first id in the range of ids used by this class.

Field Value:

1400

public static final int HIERARCHY_LAST

This is the last id in the range of ids used by this class.

Field Value:

1402

public static final int PARENT_CHANGED

This indicates that the HIERARCHY_CHANGED is a changed parent.

Field Value:

1

public static final int SHOWING_CHANGED

This indicates that the HIERARCHY_CHANGED is a changed visibility.

Field Value:

4

See Also:

Component.isShowing(), Component.addNotify(), Component.removeNotify(), Component.show(), Component.hide()

public HierarchyEvent(Component source,
                      int id,
                      Component changed,
                      Container changedParent)

Initializes a new instance of HierarchyEvent with the specified parameters. Note that an invalid id leads to unspecified results.

Parameters:

source - the component whose hierarchy changed

id - the event id

changed - the top component in the tree of changed hierarchy

changedParent - the updated parent of this object

Throws:

IllegalArgumentException - if source is null

public HierarchyEvent(Component source,
                      int id,
                      Component changed,
                      Container changedParent,
                      long changeFlags)

Initializes a new instance of HierarchyEvent with the specified parameters. Note that an invalid id leads to unspecified results.

Parameters:

source - the component whose hierarchy changed

id - the event id

changed - the top component in the tree of changed hierarchy

changedParent - the updated parent of this object

changeFlags - the bitmask of specific HIERARCHY_CHANGED events

Throws:

IllegalArgumentException - if source is null

public long getChangeFlags()

If this is a HIERARCHY_CHANGED event, this returns a bitmask of the types of changes that took place.

Returns:

the bitwise or of hierarchy change types, or 0

See Also:

PARENT_CHANGED, DISPLAYABILITY_CHANGED, SHOWING_CHANGED

public Component getChanged()

Returns the component at the top of the hierarchy which changed.

Returns:

the top changed component

public Container getChangedParent()

Returns the parent of the component listed in 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.

Returns:

the parent container of the changed component

public Component getComponent()

This method returns the event source as a Component. If the source has subsequently been modified to a non-Component, this returns null.

Returns:

the event source as a Component, or null

public String paramString()

This method returns a string identifying this event. This is the field name of the id type, followed by a parenthesized listing of the changed component and its parent container. In addition, if the type is HIERARCHY_CHANGED, the flags preceed the changed component, in the order PARENT_CHANGED, DISPLAYABILITY_CHANGED, and SHOWING_CHANGED.

Overrides:

paramString in interface AWTEvent

Returns:

a string identifying this event