summaryrefslogtreecommitdiff
path: root/libjava/java/awt/datatransfer/Transferable.java
diff options
context:
space:
mode:
Diffstat (limited to 'libjava/java/awt/datatransfer/Transferable.java')
-rw-r--r--libjava/java/awt/datatransfer/Transferable.java83
1 files changed, 36 insertions, 47 deletions
diff --git a/libjava/java/awt/datatransfer/Transferable.java b/libjava/java/awt/datatransfer/Transferable.java
index 52dac691e5b..ad957ed0868 100644
--- a/libjava/java/awt/datatransfer/Transferable.java
+++ b/libjava/java/awt/datatransfer/Transferable.java
@@ -1,5 +1,5 @@
/* Transferable.java -- Data transfer source
- Copyright (C) 1999 Free Software Foundation, Inc.
+ Copyright (C) 1999, 2002 Free Software Foundation, Inc.
This file is part of GNU Classpath.
@@ -41,52 +41,41 @@ package java.awt.datatransfer;
import java.io.IOException;
/**
- * This interface is implemented by classes that can transfer data.
- *
- * @author Aaron M. Renn (arenn@urbanophile.com)
- */
+ * This interface is implemented by classes that can transfer data.
+ *
+ * @author Aaron M. Renn <arenn@urbanophile.com>
+ * @since 1.1
+ * @status updated to 1.4
+ */
public interface Transferable
{
-
-/**
- * Returns the data in the specified <code>DataFlavor</code>
- *
- * @param flavor The data flavor to return.
- *
- * @return The data in the appropriate flavor.
- *
- * @exception UnsupportedFlavorException If the flavor is not supported.
- * @exception IOException If the data is not available.
- */
-public abstract Object
-getTransferData(DataFlavor flavor) throws UnsupportedFlavorException,
- IOException;
-
-/*************************************************************************/
-
-/**
- * This method returns a list of available data flavors for the
- * data being transferred. The array returned will be sorted from most
- * preferred flavor at the beginning to least preferred at the end.
- *
- * @return A list of data flavors for this data.
- */
-public abstract DataFlavor[]
-getTransferDataFlavors();
-
-/*************************************************************************/
-
-/**
- * Tests whether or not this data can be delivered in the specified
- * data flavor.
- *
- * @param flavor The data flavor to test.
- *
- * @return <code>true</code> if the data flavor is supported,
- * <code>false</code> otherwise.
- */
-public abstract boolean
-isDataFlavorSupported(DataFlavor flavor);
-
+ /**
+ * This method returns a list of available data flavors for the data being
+ * transferred. The array returned will be sorted from most preferred
+ * flavor at the beginning to least preferred at the end.
+ *
+ * @return adA list of data flavors for this data
+ */
+ public abstract DataFlavor[] getTransferDataFlavors();
+
+ /**
+ * Tests whether or not this data can be delivered in the specified data
+ * flavor.
+ *
+ * @param flavor the data flavor to test
+ * @return true if the data flavor is supported
+ */
+ public abstract boolean isDataFlavorSupported(DataFlavor flavor);
+
+ /**
+ * Returns the data in the specified <code>DataFlavor</code>.
+ *
+ * @param flavor the data flavor to return
+ * @return the data in the appropriate flavor
+ * @throws UnsupportedFlavorException if the flavor is not supported
+ * @throws IOException if the data is not available
+ * @see DataFlavor#getRepresentationClass
+ */
+ public abstract Object getTransferData(DataFlavor flavor)
+ throws UnsupportedFlavorException, IOException;
} // interface Transferable
-