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 and Description |
---|
StringSelection(String data)
Creates a
Transferable capable of transferring
the specified String . |
Modifier and Type | Method and Description |
---|---|
Object |
getTransferData(DataFlavor flavor)
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(DataFlavor flavor)
Returns whether the requested flavor is supported by this
Transferable . |
void |
lostOwnership(Clipboard clipboard,
Transferable contents)
Notifies this object that it is no longer the clipboard owner.
|
public StringSelection(String data)
Transferable
capable of transferring
the specified String
.public 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 dataflavor
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.
Note: The behavior of this method for
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
Reader
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 Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2011, Oracle and/or its affiliates. All rights reserved.
DRAFT ea-b138