java.awt.event
Class HierarchyEvent

java.lang.Object
  |
  +--java.util.EventObject
        |
        +--java.awt.AWTEvent
              |
              +--java.awt.event.HierarchyEvent

All Implemented Interfaces:

Serializable

public class HierarchyEvent

extends AWTEvent

An event which indicates a change to the Component hierarchy to which a Component belongs.

• Hierarchy Change Events (HierarchyListener)
  • addition of an ancestor
  • removal of an ancestor
  • hierarchy made displayable
  • hierarchy made undisplayable
  • hierarchy shown on the screen (both visible and displayable)
  • hierarchy hidden on the screen (either invisible or undisplayable)
• Ancestor Reshape Events (HierarchyBoundsListener)
  • an ancestor was resized
  • an ancestor was moved

Hierarchy events are provided for notification purposes ONLY. The AWT will automatically handle changes to the hierarchy internally so that GUI layout and displayability works properly regardless of whether a program is receiving these events or not.

This event is generated by a Container object (such as a Panel) when the Container is added, removed, moved, or resized, and passed down the hierarchy. It is also generated by a Component object when that object's addNotify, removeNotify, show, or hide method is called. ANCESTOR_MOVED and ANCESTOR_RESIZED events are dispatched to every HierarchyBoundsListener or HierarchyBoundsAdapter object which registered to receive such events using the Component's addHierarchyBoundsListener method. (HierarchyBoundsAdapter objects implement the HierarchyBoundsListener interface.) HIERARCHY_CHANGED events are dispatched to every HierarchyListener object which registered to receive such events using the Component's addHierarchyListener method. Each such listener object gets this HierarchyEvent when the event occurs.

Since:

1.3

See Also:

HierarchyListener, HierarchyBoundsAdapter, HierarchyBoundsListener, Serialized Form

Field Summary
static int	ANCESTOR_MOVED     The event id indicating an ancestor-Container was moved.
static int	ANCESTOR_RESIZED     The event id indicating an ancestor-Container was resized.
static int	DISPLAYABILITY_CHANGED     Indicates that the HIERARCHY_CHANGED event was generated due to a change in the displayability of the hierarchy.
static int	HIERARCHY_CHANGED     The event id indicating that modification was made to the entire hierarchy tree.
static int	HIERARCHY_FIRST     Marks the first integer id for the range of hierarchy event ids.
static int	HIERARCHY_LAST     Marks the last integer id for the range of ancestor event ids.
static int	PARENT_CHANGED     Indicates that the HIERARCHY_CHANGED event was generated by a reparenting operation.
static int	SHOWING_CHANGED     Indicates that the HIERARCHY_CHANGED event was generated due to a change in the showing state of the hierarchy.

 

Fields inherited from 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