Package com.vlsolutions.swing.docking.event

Events Package of the VLDocking Framework.

See:
          Description

Interface Summary
DockableSelectionListener This interface describes a listener for dockable selection changes.
DockableStateChangeListener Interface implemented by classes that need to be notified of a state change of a dockable.
DockableStateWillChangeListener Interface implemented by classes that need to be notified of a state change of a dockable before it is processed.
DockingActionListener A listener to docking actions.
 

Class Summary
DockableSelectionEvent An event for tracking selection changes of dockables.
DockableStateChangeEvent An event triggered after a change of dockable state.
DockableStateWillChangeEvent An event triggered before a change of dockable state.
DockDragEvent An event describing a drag operation occuring for docking purpose.
DockDropEvent An event send to a dockDropReceiver to complete a drop operation
DockEvent Abstract superclass of drag and drop docking events.
DockingActionAddDockableEvent A DockingActionEvent describing the first insertion of a dockable either inside a desktop docking panel (main panel) or into a compoundDockable (nested) container.
DockingActionCloseEvent A DockingActionEvent describing the closing of a dockable
DockingActionCreateTabEvent A DockingActionEvent describing a tab insertion (or movement).
DockingActionDockableEvent A DockingActionEvent involving a single dockable as source of the action.
DockingActionEvent An abstract event class describing a docking action.
DockingActionSimpleStateChangeEvent An event describing a basic state change.
DockingActionSplitComponentEvent A DockingActionEvent describing a split action (from a base component (splitcontainer, tab...)).
DockingActionSplitDockableContainerEvent A split event : split a base component in two, and puts a dockable container in the other split position.
DockingActionSplitDockableEvent A DockingActionEvent describing a split action (from a base dockable).
 

Package com.vlsolutions.swing.docking.event Description

Events Package of the VLDocking Framework.

This package contains event and listeners classes of the docking framework.

There are two types of events :

Drag and Drop events

Those events are used by the docking framework to process Docking operations.

They shoud not be used by User Applications, only by API extenders.

This category contains :

DockableState events

Those events are used for notification purpose, in order to allow the User Application to track configuration changes on the docking desktop.

Note : there are 3 states :

A state change is triggered only when a Dockable changes of state.
Keep in mind that multiple changes of docking position do not trigger multiple state change events (only the initial docking triggers the event).

This category contains :

The workflow of event delivering is the following

  Dockable in state S1 (docked/hidden/closed)

   "stateChange" requested
      event manager : triggers DockableStateWillChangeEvents
      if (event.isAccepted()){
        process state change
        ...
        Dockable in state S2 != S1 (docked/hidden/closed)
        event manager : triggers DockableStateChangeEvents

      } // else don't change state



© Copyright 2004-2007 VLSolutions. All Rights Reserved.
www.vlsolutions.com : Java Components - Smart Client Applications