com.alee.extended.tree

Class AsyncTreeTransferHandler<N extends AsyncUniqueNode,T extends WebAsyncTree<N>>

java.lang.Object

javax.swing.TransferHandler

com.alee.extended.tree.AbstractTreeTransferHandler<N,T,AsyncTreeModel<N>>

com.alee.extended.tree.AsyncTreeTransferHandler<N,T>

Type Parameters:

N - nodes type

T - tree type

All Implemented Interfaces:

java.io.Serializable

public abstract class AsyncTreeTransferHandler<N extends AsyncUniqueNode,T extends WebAsyncTree<N>>
extends AbstractTreeTransferHandler<N,T,AsyncTreeModel<N>>

Custom TransferHandler for WebAsyncTree that provides a quick and convenient way to implement nodes DnD.

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class javax.swing.TransferHandler

javax.swing.TransferHandler.DropLocation, javax.swing.TransferHandler.TransferSupport

Field Summary

Fields

Modifier and Type	Field and Description
protected boolean	allowUncheckedDrop Whether should allow dropping nodes onto not-yet-loaded node or not.

Fields inherited from class com.alee.extended.tree.AbstractTreeTransferHandler

draggedNodeIndices, draggedNodes, dropHandlers, expandMultiplyNodes, expandSingleNode, optimizeDraggedNodes

Fields inherited from class javax.swing.TransferHandler

COPY, COPY_OR_MOVE, LINK, MOVE, NONE

Constructor Summary

Constructors

Constructor and Description
AsyncTreeTransferHandler()

Method Summary

Modifier and Type	Method and Description
protected boolean	canDropTo(T tree, N destination) Returns whether or not specified destination is acceptable for drop.
protected void	informNodesDropped(T tree, java.util.List<N> nodes, N parent, AsyncTreeModel<N> model, int index) Informing about nodes drop operation.
boolean	isAllowUncheckedDrop() Returns whether should allow dropping nodes onto not-yet-loaded node or not.
protected boolean	prepareDropOperation(javax.swing.TransferHandler.TransferSupport support, T tree, java.util.List<N> nodes, int dropIndex, N parent, AsyncTreeModel<N> model) Performs all preparations required to perform drop operation and calls for actual drop when ready.
void	setAllowUncheckedDrop(boolean allowUncheckedDrop) Sets whether should allow dropping nodes onto not-yet-loaded node or not

Methods inherited from class com.alee.extended.tree.AbstractTreeTransferHandler

canBeDragged, canImport, copy, createDropHandlers, createTransferable, createTransferable, exportDone, extract, getAdjustedDropIndex, getSourceActions, getSupportedDropHandlers, importData, isCopyAction, isExpandMultiplyNodes, isExpandSingleNode, isMoveAction, isOptimizeDraggedNodes, nodesDropped, performDropOperation, removeTreeNodes, setExpandMultiplyNodes, setExpandSingleNode, setOptimizeDraggedNodes, toString

Methods inherited from class javax.swing.TransferHandler

canImport, exportAsDrag, exportToClipboard, getCopyAction, getCutAction, getDragImage, getDragImageOffset, getPasteAction, getVisualRepresentation, importData, setDragImage, setDragImageOffset

Methods inherited from class java.lang.Object

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

Field Detail

allowUncheckedDrop

protected boolean allowUncheckedDrop

Whether should allow dropping nodes onto not-yet-loaded node or not. Be aware that if this set to true and your tree might fail loading children - old nodes will still get removed on drop. If set to false tree will try to load child nodes first and then perform the drop operation.

Constructor Detail

AsyncTreeTransferHandler

public AsyncTreeTransferHandler()

Method Detail

isAllowUncheckedDrop

public boolean isAllowUncheckedDrop()

Returns whether should allow dropping nodes onto not-yet-loaded node or not.

Returns:

true if should allow dropping nodes onto not-yet-loaded node, false otherwise

setAllowUncheckedDrop

public void setAllowUncheckedDrop(boolean allowUncheckedDrop)

Sets whether should allow dropping nodes onto not-yet-loaded node or not

Parameters:

allowUncheckedDrop - whether should allow dropping nodes onto not-yet-loaded node or not

canDropTo

protected boolean canDropTo(T tree,
                            N destination)

Description copied from class: AbstractTreeTransferHandler

Returns whether or not specified destination is acceptable for drop. This check is performed before another check for nodes drop possibility.

Overrides:

canDropTo in class AbstractTreeTransferHandler<N extends AsyncUniqueNode,T extends WebAsyncTree<N>,AsyncTreeModel<N extends AsyncUniqueNode>>

Parameters:

tree - destination tree

destination - node onto which drop was performed

Returns:

true if the specified destination is acceptable for drop, false otherwise

prepareDropOperation

protected boolean prepareDropOperation(javax.swing.TransferHandler.TransferSupport support,
                                       T tree,
                                       java.util.List<N> nodes,
                                       int dropIndex,
                                       N parent,
                                       AsyncTreeModel<N> model)

Description copied from class: AbstractTreeTransferHandler

Performs all preparations required to perform drop operation and calls for actual drop when ready.

Overrides:

prepareDropOperation in class AbstractTreeTransferHandler<N extends AsyncUniqueNode,T extends WebAsyncTree<N>,AsyncTreeModel<N extends AsyncUniqueNode>>

Parameters:

support - transfer support data

tree - tree to drop nodes onto

nodes - list of nodes to drop

dropIndex - preliminary nodes drop index

parent - parent node to drop nodes into

model - tree model

Returns:

true if drop operation was successfully completed, false otherwise

informNodesDropped

protected void informNodesDropped(T tree,
                                  java.util.List<N> nodes,
                                  N parent,
                                  AsyncTreeModel<N> model,
                                  int index)

Description copied from class: AbstractTreeTransferHandler

Informing about nodes drop operation. This method is separate to allowmodifying logic of this specific call.

Overrides:

informNodesDropped in class AbstractTreeTransferHandler<N extends AsyncUniqueNode,T extends WebAsyncTree<N>,AsyncTreeModel<N extends AsyncUniqueNode>>

Parameters:

tree - tree nodes were dropped onto

nodes - list of dropped nodes

parent - parent where nodes were dropped

model - tree model

index - nodes drop index