Java java.awt.event Class HierarchyEvent（JDK8）

Field Detail

• HIERARCHY_FIRST

  public static final int HIERARCHY_FIRST

  Marks the first integer id for the range of hierarchy event ids.

  See Also:

  Constant Field Values

• HIERARCHY_CHANGED

  public static final int HIERARCHY_CHANGED

  The event id indicating that modification was made to the entire hierarchy tree.

  See Also:

  Constant Field Values

• ANCESTOR_MOVED

  public static final int ANCESTOR_MOVED

  The event id indicating an ancestor-Container was moved.

  See Also:

  Constant Field Values

• ANCESTOR_RESIZED

  public static final int ANCESTOR_RESIZED

  The event id indicating an ancestor-Container was resized.

  See Also:

  Constant Field Values

• HIERARCHY_LAST

  public static final int HIERARCHY_LAST

  Marks the last integer id for the range of ancestor event ids.

  See Also:

  Constant Field Values

• PARENT_CHANGED

  public static final int PARENT_CHANGED

  A change flag indicates that the HIERARCHY_CHANGED event was generated by a reparenting operation.

  See Also:

  Constant Field Values

• DISPLAYABILITY_CHANGED

  public static final int DISPLAYABILITY_CHANGED

  A change flag indicates that the HIERARCHY_CHANGED event was generated due to the changing of the hierarchy displayability. To discern the current displayability of the hierarchy, call the Component.isDisplayable method. Displayability changes occur in response to explicit or implicit calls of the Component.addNotify and Component.removeNotify methods.

  See Also:

  Component.isDisplayable(), Component.addNotify(), Component.removeNotify(), Constant Field Values

• SHOWING_CHANGED

  public static final int SHOWING_CHANGED

  A change flag indicates that the HIERARCHY_CHANGED event was generated due to the changing of the hierarchy showing state. To discern the current showing state of the hierarchy, call the Component.isShowing method. Showing state changes occur when either the displayability or visibility of the hierarchy occurs. Visibility changes occur in response to explicit or implicit calls of the Component.show and Component.hide methods.

  See Also:

  Component.isShowing(), Component.addNotify(), Component.removeNotify(), Component.show(), Component.hide(), Constant Field Values

Constructor Detail

• HierarchyEvent

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

  Constructs an HierarchyEvent object to identify a change in the Component hierarchy.

  This method throws an IllegalArgumentException if source is null.

  Parameters:

  source - The Component object that originated the event

  id - An integer indicating the type of event. For information on allowable values, see the class description for HierarchyEvent

  changed - The Component at the top of the hierarchy which was changed

  changedParent - The parent of the changed component. This may be the parent before or after the change, depending on the type of change

  Throws:

  IllegalArgumentException - if source is null

  See Also:

  EventObject.getSource(), AWTEvent.getID(), getChanged(), getChangedParent()

• HierarchyEvent

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

  Constructs an HierarchyEvent object to identify a change in the Component hierarchy.

  This method throws an IllegalArgumentException if source is null.

  Parameters:

  source - The Component object that originated the event

  id - An integer indicating the type of event. For information on allowable values, see the class description for HierarchyEvent

  changed - The Component at the top of the hierarchy which was changed

  changedParent - The parent of the changed component. This may be the parent before or after the change, depending on the type of change

  changeFlags - A bitmask which indicates the type(s) of the HIERARCHY_CHANGED events represented in this event object. For information on allowable values, see the class description for HierarchyEvent

  Throws:

  IllegalArgumentException - if source is null

  See Also:

  EventObject.getSource(), AWTEvent.getID(), getChanged(), getChangedParent(), getChangeFlags()

Method Detail

• getComponent

  public Component getComponent()

  Returns the originator of the event.

  Returns:

  the Component object that originated the event, or null if the object is not a Component.

• getChanged

  public Component getChanged()

  Returns the Component at the top of the hierarchy which was changed.

  Returns:

  the changed Component

• getChangedParent

  public Container getChangedParent()

  Returns the parent of the Component returned by getChanged(). For a HIERARCHY_CHANGED event where the change was of type PARENT_CHANGED via a call to Container.add, the parent returned is the parent after the add operation. For a HIERARCHY_CHANGED event where the change was of type PARENT_CHANGED via a call to Container.remove, the parent returned is the parent before the remove operation. For all other events and types, the parent returned is the parent during the operation.

  Returns:

  the parent of the changed Component

• getChangeFlags

  public long getChangeFlags()

  Returns a bitmask which indicates the type(s) of HIERARCHY_CHANGED events represented in this event object. The bits have been bitwise-ored together.

  Returns:

  the bitmask, or 0 if this is not an HIERARCHY_CHANGED event

• paramString

  public String paramString()

  Returns a parameter string identifying this event. This method is useful for event-logging and for debugging.

  Overrides:

  paramString in class AWTEvent

  Returns:

  a string identifying the event and its attributes