StringSelection類

此類用於傳輸選取的文本。文本形式支持 DataFlavor.stringFlavor 及所有等效 flavor。

基本介紹

• 中文名：StringSelection類
• 外文名：StringSelection類
• 接口繼承關係：java.lang.Object
• 另請參見：構造方法摘要

接口繼承關係

java.awt.datatransfer類 StringSelection

java.lang.Object

java.awt.datatransfer.StringSelection

所有已實現的接口

ClipboardOwner, Transferablepublic class StringSelection extends Objectimplements 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 booleanisDataFlavorSupported(DataFlavor flavor)返回所請求的 flavor 是否受此 Transferable 支持。

指定者：接口 Transferable 中的 isDataFlavorSupported

參數：flavor - 所請求的數據 flavor

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

拋出：NullPointerException - 如果 flavor 為 null

getTransferData

public ObjectgetTransferData(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.plainTextFlavorIOException - 如果檢索數據時發生 IOException。默認情況下，StringSelection 不會拋出此異常，但是其子類可以。 NullPointerException - 如果 flavor 為 null

另請參見：Reader

lostOwnership

public void lostOwnership(Clipboard clipboard, Transferable contents)

從接口ClipboardOwner 複製的描述通知此對象，它已不再是剪貼簿所有者。當其他應用程式或此應用程式中的其他對象維護剪貼簿的所有權時，調用此方法。

指定者：接口 ClipboardOwner 中的 lostOwnership

參數：clipboard - 不再擁有的剪貼簿 contents - 此所有者置於剪貼簿上的內容