org.openide.loaders 5.9.22

org.openide.loaders
Class LoaderTransfer

java.lang.Object
  extended by org.openide.loaders.LoaderTransfer

public abstract class LoaderTransfer
extends Object

Class that contains specific datatransfer flavors and methods to work with transfered DataObjects. There are flavors to allow a DataObject to be copied or cut into clipboard, and to retrieve them from clipboard when implementing paste operation.

This is a dummy utility class--no instances are possible.

Since:
1.21

Field Summary
static int CLIPBOARD_COPY
          Constant indicating copying to the clipboard.
static int CLIPBOARD_CUT
          Constant indicating cutting to the clipboard.
static int COPY
          Generic mask for copying DataObjects (do not destroy the original).
static int DND_COPY
           
static int DND_COPY_OR_MOVE
           
static int DND_LINK
           
static int DND_MOVE
           
static int DND_NONE
          Constants for drag-n-drop operations.
static int DND_REFERENCE
           
static int MOVE
          Generic mask for moving DataObjects (destroy the original).
 
Method Summary
static DataObject getDataObject(Transferable t, int action)
          Obtain a DataObject from a transferable.
static DataObject[] getDataObjects(Transferable t, int action)
          Obtain a list of DataObjects from a transferable.
static ExTransferable.Single transferable(DataObject d, int actions)
          Creates transferable that represents an operation, such as cut-to-clipboard.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

DND_NONE

public static final int DND_NONE
Constants for drag-n-drop operations. Are exactly the same as constants in DnDConstants.

See Also:
Constant Field Values

DND_COPY

public static final int DND_COPY
See Also:
Constant Field Values

DND_MOVE

public static final int DND_MOVE
See Also:
Constant Field Values

DND_COPY_OR_MOVE

public static final int DND_COPY_OR_MOVE
See Also:
Constant Field Values

DND_LINK

public static final int DND_LINK
See Also:
Constant Field Values

DND_REFERENCE

public static final int DND_REFERENCE
See Also:
Constant Field Values

CLIPBOARD_COPY

public static final int CLIPBOARD_COPY
Constant indicating copying to the clipboard. Equal to DND_COPY, because copy to clipboard and d'n'd copy should be the same.

See Also:
Constant Field Values

CLIPBOARD_CUT

public static final int CLIPBOARD_CUT
Constant indicating cutting to the clipboard.

See Also:
Constant Field Values

COPY

public static final int COPY
Generic mask for copying DataObjects (do not destroy the original). Equal to CLIPBOARD_COPY or DND_COPY.

See Also:
Constant Field Values

MOVE

public static final int MOVE
Generic mask for moving DataObjects (destroy the original). Equal to CLIPBOARD_CUT or DND_MOVE.

See Also:
Constant Field Values
Method Detail

transferable

public static ExTransferable.Single transferable(DataObject d,
                                                 int actions)
Creates transferable that represents an operation, such as cut-to-clipboard. The transferable will be recognizable by getDataObject(java.awt.datatransfer.Transferable, int) and getDataObjects(java.awt.datatransfer.Transferable, int).

Parameters:
d - the DataObject to create a transferable for
actions - the action performed on the DataObject's node
Returns:
the transferable

getDataObject

public static DataObject getDataObject(Transferable t,
                                       int action)
Obtain a DataObject from a transferable. Probes the transferable in case it includes a flavor corresponding to a DataObject's node operation (which you must specify a mask for).

Parameters:
t - transferable
action - one of the DND_* or CLIPBOARD_* constants
Returns:
the DataObject or null

getDataObjects

public static DataObject[] getDataObjects(Transferable t,
                                          int action)
Obtain a list of DataObjects from a transferable. If there is only a single DataObject in the transferable, this will just return a singleton array like getDataObject(java.awt.datatransfer.Transferable, int). If there is a multiple transfer (of at least one element), each element of which contains a DataObject, then an array of these will be returned. If neither of these things is true, null will be returned.

This is a convenience method intended for those who wish to specially support pastes of multiple DataObjects at once.

Parameters:
t - the transferable to probe
action - a DnD or clipboard constant
Returns:
a non-empty array of nodes, or null

org.openide.loaders 5.9.22

Built on July 11 2007.  |  Portions Copyright 1997-2005 Sun Microsystems, Inc. All rights reserved.