furbelow

Class DropTargetNavigator

java.lang.Object

furbelow.DropTargetNavigator

All Implemented Interfaces:

DragSourceListener, DragSourceMotionListener, EventListener

public class DropTargetNavigator
extends Object
implements DragSourceListener, DragSourceMotionListener

Provides auto-scrolling behavior on scrollable components which do not implement Autoscroll, and various other aids to positioning drop targets during a drag.

• Switch tabs in a JTabbedPane
• Expand nodes in a JTree
• Autoscroll components that wouldn't be otherwise

Ideally, there would be a DropTargetNavigable interface similar to DropTargetNavigator.Navigator here, and components would implement it as needed. For this implementation, custom classes requiring drop target navigation should register a handler for themselves in the static initializer for that class.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	DropTargetNavigator.AbstractNavigator
static interface	DropTargetNavigator.Navigator This performs a more general navigation function than Autoscroll.

Constructor Summary

Constructors

Constructor and Description
DropTargetNavigator()
DropTargetNavigator(DragSource src)

Method Summary

Modifier and Type	Method and Description
static void	disableDropTargetNavigation() Disable system-wide drop target navigation.
void	dispose()
void	dragDropEnd(DragSourceDropEvent e)
void	dragEnter(DragSourceDragEvent e)
void	dragExit(DragSourceEvent e)
void	dragMouseMoved(DragSourceDragEvent e)
void	dragOver(DragSourceDragEvent e)
void	dropActionChanged(DragSourceDragEvent e)
static void	enableDropTargetNavigation() Enable system-wide drop target navigation.
static RootPaneContainer	findRootPaneContainer(Container c) Find the first instance of RootPaneContainer in the given container.
static int	getNavigationDelay() Returns the current setting of the auto-navigation delay.
static void	register(Class cls, DropTargetNavigator.Navigator navigator) Register a new navigator for the given component class.
static void	setNavigationDelay(int ms) Change the delay (in ms) in starting an automatic navigation.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

DropTargetNavigator

public DropTargetNavigator()

DropTargetNavigator

public DropTargetNavigator(DragSource src)

Method Detail

setNavigationDelay

public static void setNavigationDelay(int ms)

Change the delay (in ms) in starting an automatic navigation.

getNavigationDelay

public static int getNavigationDelay()

Returns the current setting of the auto-navigation delay.

register

public static void register(Class cls,
                            DropTargetNavigator.Navigator navigator)

Register a new navigator for the given component class.

enableDropTargetNavigation

public static void enableDropTargetNavigation()

Enable system-wide drop target navigation.

disableDropTargetNavigation

public static void disableDropTargetNavigation()

Disable system-wide drop target navigation.

dragEnter

public void dragEnter(DragSourceDragEvent e)

Specified by:

dragEnter in interface DragSourceListener

dragOver

public void dragOver(DragSourceDragEvent e)

Specified by:

dragOver in interface DragSourceListener

dropActionChanged

public void dropActionChanged(DragSourceDragEvent e)

Specified by:

dropActionChanged in interface DragSourceListener

dragExit

public void dragExit(DragSourceEvent e)

Specified by:

dragExit in interface DragSourceListener

dragMouseMoved

public void dragMouseMoved(DragSourceDragEvent e)

Specified by:

dragMouseMoved in interface DragSourceMotionListener

dragDropEnd

public void dragDropEnd(DragSourceDropEvent e)

Specified by:

dragDropEnd in interface DragSourceListener

dispose

public void dispose()

findRootPaneContainer

public static RootPaneContainer findRootPaneContainer(Container c)

Find the first instance of RootPaneContainer in the given container. Basically finds applets.