ClipboardOwner
, Transferable
public class StringSelection extends Object implements Transferable, ClipboardOwner
Transferable
which implements the capability required to transfer a String
. This Transferable
properly supports DataFlavor.stringFlavor
and all equivalent flavors. Support for DataFlavor.plainTextFlavor
and all equivalent flavors is deprecated. No other DataFlavor
s are supported.
Constructor | Description |
---|---|
StringSelection |
Creates a Transferable capable of transferring the specified String . |
Modifier and Type | Method | Description |
---|---|---|
Object |
getTransferData |
Returns the Transferable 's data in the requested DataFlavor if possible. |
DataFlavor[] |
getTransferDataFlavors() |
Returns an array of flavors in which this Transferable can provide the data. |
boolean |
isDataFlavorSupported |
Returns whether the requested flavor is supported by this Transferable . |
void |
lostOwnership |
Notifies this object that it is no longer the clipboard owner. |
public StringSelection(String data)
Transferable
capable of transferring the specified String
.data
- the string to be transferredpublic DataFlavor[] getTransferDataFlavors()
Transferable
can provide the data. DataFlavor.stringFlavor
is properly supported. Support for DataFlavor.plainTextFlavor
is deprecated.getTransferDataFlavors
in interface Transferable
DataFlavor.stringFlavor
and DataFlavor.plainTextFlavor
public boolean isDataFlavorSupported(DataFlavor flavor)
Transferable
.isDataFlavorSupported
in interface Transferable
flavor
- the requested flavor for the datatrue
if flavor
is equal to DataFlavor.stringFlavor
or DataFlavor.plainTextFlavor
; false
if flavor
is not one of the above flavorsNullPointerException
- if flavor
is null
public Object getTransferData(DataFlavor flavor) throws UnsupportedFlavorException, IOException
Transferable
's data in the requested DataFlavor
if possible. If the desired flavor is DataFlavor.stringFlavor
, or an equivalent flavor, the String
representing the selection is returned. If the desired flavor is DataFlavor.plainTextFlavor
, or an equivalent flavor, a Reader
is returned. DataFlavor.plainTextFlavor
and equivalent DataFlavor
s is inconsistent with the definition of DataFlavor.plainTextFlavor
.getTransferData
in interface Transferable
flavor
- the requested flavor for the dataUnsupportedFlavorException
- if the requested data flavor is not equivalent to either DataFlavor.stringFlavor
or DataFlavor.plainTextFlavor
IOException
- if an IOException occurs while retrieving the data. By default, StringSelection never throws this exception, but a subclass may.NullPointerException
- if flavor
is null
public void lostOwnership(Clipboard clipboard, Transferable contents)
ClipboardOwner
lostOwnership
in interface ClipboardOwner
clipboard
- the clipboard that is no longer ownedcontents
- the contents which this owner had placed on the clipboard
© 1993, 2023, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/21/docs/api/java.datatransfer/java/awt/datatransfer/StringSelection.html