bibliothek.gui.dock.event
Interface DockStationListener

All Known Implementing Classes:
DockableShowingManager, DockStationAdapter, ExternalizingCGridAreaConfiguration.SplitInserter

@LayoutLocked
public interface DockStationListener

This listener is added to a DockStation. It receives events on adding or removing children of the station, or if the visibility of a child has changed.

Author:
Benjamin Sigg

Method Summary
 void dockableAdded(DockStation station, Dockable dockable)
          Invoked after dockable has been added to station.
Note: this method is called when the tree of DockElements contains the new element, other properties - like the bounds of the Component of dockable - might not yet be set.
 void dockableAdding(DockStation station, Dockable dockable)
          Invoked before dockable is added to station.
 void dockableRemoved(DockStation station, Dockable dockable)
          Invoked after dockable has been removed from station.
 void dockableRemoving(DockStation station, Dockable dockable)
          Invoked before dockable is removed from station.
 void dockableSelected(DockStation station, Dockable oldSelection, Dockable newSelection)
          Called when dockable has been selected.
 void dockableShowingChanged(DockStation station, Dockable dockable, boolean showing)
          Invoked if the visibility of a child has been changed.
 void dockablesRepositioned(DockStation station, Dockable[] dockables)
          Called when the location and/or size of one or several dockables changed.
 

Method Detail

dockableAdding

void dockableAdding(DockStation station,
                    Dockable dockable)
Invoked before dockable is added to station.

Parameters:
station - the station where the new child will be added
dockable - the new child

dockableRemoving

void dockableRemoving(DockStation station,
                      Dockable dockable)
Invoked before dockable is removed from station.

Parameters:
station - the station where the old child will be removed
dockable - the old child

dockableAdded

void dockableAdded(DockStation station,
                   Dockable dockable)
Invoked after dockable has been added to station.
Note: this method is called when the tree of DockElements contains the new element, other properties - like the bounds of the Component of dockable - might not yet be set.

Parameters:
station - the station where the new child was added
dockable - the new child

dockableRemoved

void dockableRemoved(DockStation station,
                     Dockable dockable)
Invoked after dockable has been removed from station.

Parameters:
station - the station where the old child was removed
dockable - the old child

dockableShowingChanged

void dockableShowingChanged(DockStation station,
                            Dockable dockable,
                            boolean showing)
Invoked if the visibility of a child has been changed. In this context visibility means whether the user can or cannot see the dockable. See also Dockable.isDockableShowing().
Callers may use the class DockableShowingManager to organize the calls in an easy way.

Parameters:
station - the station whose children have changed their visibility
dockable - the Dockable whose visibility has changed
showing - the new visibility-state

dockableSelected

void dockableSelected(DockStation station,
                      Dockable oldSelection,
                      Dockable newSelection)
Called when dockable has been selected. The value of dockable should be the same as DockStation.getFrontDockable().

Parameters:
station - the source of the event
oldSelection - the element which was selected before the change, can be null
newSelection - the current value of DockStation.getFrontDockable(), can be null

dockablesRepositioned

void dockablesRepositioned(DockStation station,
                           Dockable[] dockables)
Called when the location and/or size of one or several dockables changed. This means that DockStation.getDockableProperty(Dockable, Dockable) now returns another value than before. This method may or may not be called for Dockables that were just added or being removed from station.

Parameters:
station - the source of the event
dockables - the affected elements