java.awt.datatransfer
類別 StringSelection

java.lang.Object
  java.awt.datatransfer.StringSelection

所有已實作的介面：

ClipboardOwner, Transferable

public class StringSelection
extends Object
implements Transferable, ClipboardOwner

實作傳輸 String 所需能力的 Transferable。此 Transferable 可以正確支持 DataFlavor.stringFlavor 及所有等效 flavor。對 DataFlavor.plainTextFlavor 及所有等效 flavor 的支持已被廢棄。不支持其他 DataFlavor。

另請參見：

DataFlavor.stringFlavor, DataFlavor.plainTextFlavor

建構子摘要

StringSelection(String data)
創建能傳輸指定 String 的 Transferable。

方法摘要

Object	getTransferData(DataFlavor flavor) 如果可能，則使用請求的 DataFlavor 返回 Transferable 的資料。
DataFlavor[]	getTransferDataFlavors() 返回 flavor 的陣列，Transferable 可用該 flavor 提供資料。
boolean	isDataFlavorSupported(DataFlavor flavor) 返回所請求的 flavor 是否受此 Transferable 支持。
void	lostOwnership(Clipboard clipboard, Transferable contents) 通知此物件，它已不再是剪貼板所有者。

從類別 java.lang.Object 繼承的方法

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

建構子詳細資訊

StringSelection

public StringSelection(String data)

創建能傳輸指定 String 的 Transferable。

方法詳細資訊

getTransferDataFlavors

public DataFlavor[] getTransferDataFlavors()

返回 flavor 的陣列，Transferable 可用該 flavor 提供資料。正確支持 DataFlavor.stringFlavor。對 DataFlavor.plainTextFlavor 的支持已被廢棄。

指定者：

介面 Transferable 中的 getTransferDataFlavors

返回：

長度為 2 的陣列，其元素為 DataFlavor. stringFlavor 和 DataFlavor.plainTextFlavor

isDataFlavorSupported

public boolean isDataFlavorSupported(DataFlavor flavor)

返回所請求的 flavor 是否受此 Transferable 支持。

指定者：

介面 Transferable 中的 isDataFlavorSupported

參數：

flavor - 所請求的資料 flavor

返回：

如果 flavor 等於 DataFlavor.stringFlavor 或 DataFlavor.plainTextFlavor，則為 true；如果 flavor 不是上述兩種 flavor 之一，則為 false

拋出：

NullPointerException - 如果 flavor 為 null

getTransferData

public Object getTransferData(DataFlavor flavor)
                       throws UnsupportedFlavorException,
                              IOException

如果可能，則使用請求的 DataFlavor 返回 Transferable 的資料。如果需要的 flavor 是 DataFlavor.stringFlavor 或其等效 flavor，則返回表示這一選擇的 String。如果需要的 flavor 是 DataFlavor.plainTextFlavor 或其等效 flavor，則返回 Reader。註：針對 DataFlavor.plainTextFlavor 及其等效的 DataFlavor 的此方法的行為與 DataFlavor.plainTextFlavor 的定義不一致。

指定者：

介面 Transferable 中的 getTransferData

參數：

flavor - 請求的資料 flavor

返回：

按照上面的描述使用請求的 flavor 返回資料

拋出：

UnsupportedFlavorException - 如果請求的資料 flavor 既不等效於 DataFlavor.stringFlavor 也不等效於 DataFlavor.plainTextFlavor

IOException - 如果檢索資料時發生 IOException。預設情況下，StringSelection 不會拋出此異常，但是其子類別可以。

NullPointerException - 如果 flavor 為 null

另請參見：

Reader

lostOwnership

public void lostOwnership(Clipboard clipboard,
                          Transferable contents)

從介面 ClipboardOwner 複製的描述

通知此物件，它已不再是剪貼板所有者。當其他應用程序或此應用程序中的其他物件維護剪貼板的所有權時，調用此方法。

指定者：

介面 ClipboardOwner 中的 lostOwnership

參數：

clipboard - 不再擁有的剪貼板

contents - 此所有者置於剪貼板上的內容