< prev index next >

src/java.datatransfer/share/classes/java/awt/datatransfer/Transferable.java

Print this page

        

*** 1,7 **** /* ! * Copyright (c) 1996, 2014, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it * under the terms of the GNU General Public License version 2 only, as * published by the Free Software Foundation. Oracle designates this --- 1,7 ---- /* ! * Copyright (c) 1996, 2017, Oracle and/or its affiliates. All rights reserved. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * * This code is free software; you can redistribute it and/or modify it * under the terms of the GNU General Public License version 2 only, as * published by the Free Software Foundation. Oracle designates this
*** 26,74 **** package java.awt.datatransfer; import java.io.IOException; /** ! * Defines the interface for classes that can be used to provide data ! * for a transfer operation. * <p> * For information on using data transfer with Swing, see * <a href="http://docs.oracle.com/javase/tutorial/uiswing/dnd/index.html"> ! * How to Use Drag and Drop and Data Transfer</a>, ! * a section in <em>The Java Tutorial</em>, for more information. * * @author Amy Fowler */ - public interface Transferable { /** * Returns an array of DataFlavor objects indicating the flavors the data * can be provided in. The array should be ordered according to preference ! * for providing the data (from most richly descriptive to least descriptive). * @return an array of data flavors in which this data can be transferred */ public DataFlavor[] getTransferDataFlavors(); /** ! * Returns whether or not the specified data flavor is supported for ! * this object. * @param flavor the requested flavor for the data * @return boolean indicating whether or not the data flavor is supported */ public boolean isDataFlavorSupported(DataFlavor flavor); /** * Returns an object which represents the data to be transferred. The class ! * of the object returned is defined by the representation class of the flavor. * * @param flavor the requested flavor for the data * @return an object which represents the data to be transferred * @see DataFlavor#getRepresentationClass - * @exception IOException if the data is no longer available - * in the requested flavor. - * @exception UnsupportedFlavorException if the requested data flavor is - * not supported. */ public Object getTransferData(DataFlavor flavor) throws UnsupportedFlavorException, IOException; - } --- 26,76 ---- package java.awt.datatransfer; import java.io.IOException; /** ! * Defines the interface for classes that can be used to provide data for a ! * transfer operation. * <p> * For information on using data transfer with Swing, see * <a href="http://docs.oracle.com/javase/tutorial/uiswing/dnd/index.html"> ! * How to Use Drag and Drop and Data Transfer</a>, a section in ! * <em>The Java Tutorial</em>, for more information. * * @author Amy Fowler */ public interface Transferable { /** * Returns an array of DataFlavor objects indicating the flavors the data * can be provided in. The array should be ordered according to preference ! * for providing the data (from most richly descriptive to least ! * descriptive). ! * * @return an array of data flavors in which this data can be transferred */ public DataFlavor[] getTransferDataFlavors(); /** ! * Returns whether or not the specified data flavor is supported for this ! * object. ! * * @param flavor the requested flavor for the data * @return boolean indicating whether or not the data flavor is supported */ public boolean isDataFlavorSupported(DataFlavor flavor); /** * Returns an object which represents the data to be transferred. The class ! * of the object returned is defined by the representation class of the ! * flavor. * * @param flavor the requested flavor for the data * @return an object which represents the data to be transferred + * @throws IOException if the data is no longer available in the requested + * flavor + * @throws UnsupportedFlavorException if the requested data flavor is not + * supported * @see DataFlavor#getRepresentationClass */ public Object getTransferData(DataFlavor flavor) throws UnsupportedFlavorException, IOException; }
< prev index next >