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 org.openide.util.datatransfer.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​(java.awt.datatransfer.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​(java.awt.datatransfer.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