Docjar: A Java Source and Docuemnt Enginecom.*    java.*    javax.*    org.*    all    new    plug-in

Quick Search    Search Deep

org.eclipse.swt.dnd
Class Transfer  view Transfer download Transfer.java

java.lang.Object
  extended byorg.eclipse.swt.dnd.Transfer
Direct Known Subclasses:
ByteArrayTransfer

public abstract class Transfer
extends java.lang.Object

Transfer provides a mechanism for converting between a java representation of data and a platform specific representation of data and vice versa. It is used in data transfer operations such as drag and drop and clipboard copy/paste.

You should only need to become familiar with this class if you are implementing a Transfer subclass and you are unable to subclass the ByteArrayTransfer class.


Constructor Summary
Transfer()
           
 
Method Summary
abstract  TransferData[] getSupportedTypes()
          Returns a list of the platform specific data types that can be converted using this transfer agent.
protected abstract  int[] getTypeIds()
          Returns the platform specfic ids of the data types that can be converted using this transfer agent.
protected abstract  java.lang.String[] getTypeNames()
          Returns the platform specfic names of the data types that can be converted using this transfer agent.
abstract  boolean isSupportedType(TransferData transferData)
          Returns true if the TransferData data type can be converted using this transfer agent.
protected abstract  void javaToNative(java.lang.Object object, TransferData transferData)
          Converts a java representation of data to a platform specific representation of the data.
protected abstract  java.lang.Object nativeToJava(TransferData transferData)
          Converts a platform specific representation of data to a java representation.
static int registerType(java.lang.String formatName)
          Registers a name for a data type and returns the associated unique identifier.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

Transfer

public Transfer()
Method Detail

getSupportedTypes

public abstract TransferData[] getSupportedTypes()
Returns a list of the platform specific data types that can be converted using this transfer agent.

Only the data type fields of the TransferData objects are filled in.


isSupportedType

public abstract boolean isSupportedType(TransferData transferData)
Returns true if the TransferData data type can be converted using this transfer agent.


getTypeNames

protected abstract java.lang.String[] getTypeNames()
Returns the platform specfic names of the data types that can be converted using this transfer agent.


getTypeIds

protected abstract int[] getTypeIds()
Returns the platform specfic ids of the data types that can be converted using this transfer agent.


javaToNative

protected abstract void javaToNative(java.lang.Object object,
                                     TransferData transferData)
Converts a java representation of data to a platform specific representation of the data.

On a successful conversion, the transferData.result field will be set as follows:

  • Windows: COM.S_OK
  • Motif: 1
  • GTK: 1
  • Photon: 1

If this transfer agent is unable to perform the conversion, the transferData.result field will be set to a failure value as follows:

  • Windows: COM.DV_E_TYMED or COM.E_FAIL
  • Motif: 0
  • GTK: 0
  • Photon: 0


nativeToJava

protected abstract java.lang.Object nativeToJava(TransferData transferData)
Converts a platform specific representation of data to a java representation.


registerType

public static int registerType(java.lang.String formatName)
Registers a name for a data type and returns the associated unique identifier.

You may register the same type more than once, the same unique identifier will be returned if the type has been previously registered.

Note: On windows, do not call this method with pre-defined Clipboard Format types such as CF_TEXT or CF_BITMAP because the pre-defined identifier will not be returned