com.vlsolutions.swing.docking

Class DockingUtilities

public class DockingUtilities extends Object

Utility class implementing search/replace algorithms used by the framework.

This class is not inteded for API users, it should be let to framework developpers.

Method Summary
static booleancanUseMouseInfo()
Returns whether we can use the secured and 1.5 MouseInfo class
static voiddispose(FloatingDockableContainer fdc)
disposes a detached dockable, regardless of its type (frame or dialog)
static ContainerfindCompoundAncestorContainer(Dockable dockable)
searches up the dockable container hierarchy and returns the first ancestor which is a CompoundDockable (or null if not found).
static ArrayListfindCompoundDockableChildren(CompoundDockable compoundDockable)
Creates a list of all dockable children contained in the given compound dockable.
static DockableContainerfindDockableContainer(Dockable dockable)
returns the first DockableContainer which is parent of this dockable component
static SingleDockableContainerfindSingleDockableContainer(Dockable dockable)
returns the first DockableContainer which is parent of this dockable component
static SingleDockableContainerfindSingleDockableContainerAncestor(Component component)
A utility method to find the first single dockable container ancestor of the given component.
static TabbedDockableContainerfindTabbedDockableContainer(Dockable dockable)
Returns the first TabbedDockableContainer which is parent of this dockable component, or null is there isn't any.
static intgetDockableStateFromHierarchy(Component comp)
Returns a DockableState value corresponding to this component or -1 if not found.
static PointgetMouseLocation()
Returns the mouse location on screen or null if ran in an untrusted environement/ java 1.4
static JRootPanegetRootPane(FloatingDockableContainer fdc)
returns the root pane used by this detached dockable container, regardless of its type (frame or dialog)
static SplitContainergetSplitPane(Dockable dockable, int orientation)
Returns the split pane containing this dockable (if any), or null if this dockable isn't contained in a splitpane.
static intgetTopMostAncestorContainerState(Dockable dockable)
searches up the dockable container hierarchy and returns the dockable state of the last (top most) ancestor which is a CompoundDockable (or -1 if not found).
static booleanisChildOfCompoundDockable(Dockable dockable)
checks if this dockable is a child of a compound dockable
static booleanisHeavyWeightComponent(Component comp)
Utility method to find out if a component is heavyweight (of if it contains a heavyweight comp)
static voidpack(FloatingDockableContainer fdc)
packs a detached dockable, regardless of its type (frame or dialog)
static voidreplaceChild(Container parent, Component child, Component newChild)
Child replacement
static voidsetLocation(FloatingDockableContainer fdc, Point location)
positions a detached dockable, regardless of its type (frame or dialog)
static voidsetLocationRelativeTo(FloatingDockableContainer fdc, Component rel)
positions a detached dockable, regardless of its type (frame or dialog)
static voidsetSize(FloatingDockableContainer fdc, Dimension size)
resizes a detached dockable, regardless of its type (frame or dialog)
static voidsetVisible(FloatingDockableContainer fdc, boolean visible)
shows a detached dockable, regardless of its type (frame or dialog)
static voidswapComponents(Component comp1, Component comp2)
Swaps two toplevel DockableContainers (their parent must be a SplitContainer)
static voidupdateResizeWeights(DockingPanel dockingPanel)
Invoked every time the layout is changed, to rebuild the weighting of split containers
static voidvalidate(FloatingDockableContainer fdc)
validates a detached dockable, regardless of its type (frame or dialog)

Method Detail

canUseMouseInfo

public static boolean canUseMouseInfo()
Returns whether we can use the secured and 1.5 MouseInfo class

dispose

public static void dispose(FloatingDockableContainer fdc)
disposes a detached dockable, regardless of its type (frame or dialog)

findCompoundAncestorContainer

public static Container findCompoundAncestorContainer(Dockable dockable)
searches up the dockable container hierarchy and returns the first ancestor which is a CompoundDockable (or null if not found).

findCompoundDockableChildren

public static ArrayList findCompoundDockableChildren(CompoundDockable compoundDockable)
Creates a list of all dockable children contained in the given compound dockable.

If the compound dockable contains another compound dockable this one is also added, along with its own children.

Returns: an ArrayList of Dockable

findDockableContainer

public static DockableContainer findDockableContainer(Dockable dockable)
returns the first DockableContainer which is parent of this dockable component

findSingleDockableContainer

public static SingleDockableContainer findSingleDockableContainer(Dockable dockable)
returns the first DockableContainer which is parent of this dockable component

findSingleDockableContainerAncestor

public static SingleDockableContainer findSingleDockableContainerAncestor(Component component)
A utility method to find the first single dockable container ancestor of the given component.

This method may return null if no SingleDockableContainer ancestor is found.

findTabbedDockableContainer

public static TabbedDockableContainer findTabbedDockableContainer(Dockable dockable)
Returns the first TabbedDockableContainer which is parent of this dockable component, or null is there isn't any.

getDockableStateFromHierarchy

public static int getDockableStateFromHierarchy(Component comp)
Returns a DockableState value corresponding to this component or -1 if not found.

Two states are currently managed : docked and floating (not hidden/maximized/closed).

getMouseLocation

public static Point getMouseLocation()
Returns the mouse location on screen or null if ran in an untrusted environement/ java 1.4

getRootPane

public static JRootPane getRootPane(FloatingDockableContainer fdc)
returns the root pane used by this detached dockable container, regardless of its type (frame or dialog)

getSplitPane

public static SplitContainer getSplitPane(Dockable dockable, int orientation)
Returns the split pane containing this dockable (if any), or null if this dockable isn't contained in a splitpane.

If the dockable is nested in a TabbedDockableContainer, the split pane returned will be the one containing the tabbed container (if any).

getTopMostAncestorContainerState

public static int getTopMostAncestorContainerState(Dockable dockable)
searches up the dockable container hierarchy and returns the dockable state of the last (top most) ancestor which is a CompoundDockable (or -1 if not found).

isChildOfCompoundDockable

public static boolean isChildOfCompoundDockable(Dockable dockable)
checks if this dockable is a child of a compound dockable

isHeavyWeightComponent

public static boolean isHeavyWeightComponent(Component comp)
Utility method to find out if a component is heavyweight (of if it contains a heavyweight comp)

pack

public static void pack(FloatingDockableContainer fdc)
packs a detached dockable, regardless of its type (frame or dialog)

replaceChild

public static void replaceChild(Container parent, Component child, Component newChild)
Child replacement

setLocation

public static void setLocation(FloatingDockableContainer fdc, Point location)
positions a detached dockable, regardless of its type (frame or dialog)

setLocationRelativeTo

public static void setLocationRelativeTo(FloatingDockableContainer fdc, Component rel)
positions a detached dockable, regardless of its type (frame or dialog)

setSize

public static void setSize(FloatingDockableContainer fdc, Dimension size)
resizes a detached dockable, regardless of its type (frame or dialog)

setVisible

public static void setVisible(FloatingDockableContainer fdc, boolean visible)
shows a detached dockable, regardless of its type (frame or dialog)

swapComponents

public static void swapComponents(Component comp1, Component comp2)
Swaps two toplevel DockableContainers (their parent must be a SplitContainer)

updateResizeWeights

public static void updateResizeWeights(DockingPanel dockingPanel)
Invoked every time the layout is changed, to rebuild the weighting of split containers

validate

public static void validate(FloatingDockableContainer fdc)
validates a detached dockable, regardless of its type (frame or dialog)
© Copyright 2004-2007 VLSolutions. All Rights Reserved.
www.vlsolutions.com : Java Components - Smart Client Applications