Clipboard類

Clipboard類，此類實現一種使用剪下/複製/貼上操作傳輸數據的機制，繼承關係為java.lang.Object。

基本介紹

• 中文名：Clipboard類
• owner：protected ClipboardOwner owner
• contents：protected Transferable
• 繼承關係：java.lang.Object

繼承關係

java.lang.Object

java.awt.datatransfer.Clipboard

public class Clipboard extends Object

此類實現一種使用剪下/複製/貼上操作傳輸數據的機制。

FlavorListener 可以在 Clipboard 類的實例上註冊，以接收對此剪貼簿上可用的 DataFlavor 的集合更改的通知（參見 addFlavorListener(java.awt.datatransfer.FlavorListener)。

另請參見

Toolkit.getSystemClipboard(), Toolkit.getSystemSelection()

欄位摘要

protected Transferable contents

protected ClipboardOwner owner

構造方法摘要

Clipboard(String name) 創建剪貼簿對象。

方法摘要

void	addFlavorListener(FlavorListener listener)	註冊指定的 FlavorListener，以從此剪貼簿接收 FlavorEvent。
DataFlavor[]	getAvailableDataFlavors()	返回 DataFlavor 的數組，其中提供了此剪貼簿的當前內容。
Transferable	getContents(Object requestor)	返回表示剪貼簿當前內容的 transferable 對象。
Object	getData(DataFlavor flavor)	返回一個對象，表示此剪貼簿中指定 DataFlavor 類型的當前內容。
FlavorListener[]	getFlavorListeners()	返回一組目前在此 Clipboard 上註冊的所有 FlavorListener。
String	getName()	返回此剪貼簿對象的名稱。
boolean	isDataFlavorAvailable(DataFlavor flavor)	返回是否能夠以指定的 DataFlavor 形式提供此剪貼簿的當前內容。
void	removeFlavorListener(FlavorListener listener)	移除指定的 FlavorListener，使其不再從此 Clipboard 接收 FlavorEvent。
void	setContents(Transferable contents, ClipboardOwner owner)	將剪貼簿的當前內容設定到指定的 transferable 對象，並將指定的剪貼簿所有者作為新內容的所有者註冊。

從 Object 繼承的方法

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

欄位詳細信息

owner

protected ClipboardOwner owner

contents

protected Transferable contents

構造方法詳細信]息b]

Clipboard

publicClipboard(String name)創建剪貼簿對象。

另請參見

Toolkit.getSystemClipboard()

方法詳細信息

getName

public StringgetName()返回此剪貼簿對象的名稱。 另請參見：Toolkit.getSystemClipboard()

setContents

public void setContents(Transferable contents, ClipboardOwner owner)將剪貼簿的當前內容設定到指定的 transferable 對象，並將指定的剪貼簿所有者作為新內容的所有者註冊。

如果現有的所有者與參數 owner 不同，則該所有者將得到通知，它已不再保持剪貼簿內容的所有關係，此操作是通過對該所有者調用 ClipboardOwner.lostOwnership() 完成的。setContents() 的實現可以不直接從此方法調用 lostOwnership()。例如，可以稍後在另一個執行緒上調用 lostOwnership()。在此剪貼簿上註冊的 FlavorListener 也是如此。

如果剪貼簿當前不可用，則該方法拋出 IllegalStateException。例如，在某些平台上，系統剪貼簿在被別的應用程式訪問時是不可用的。

參數：contents - 表示剪貼簿內容的 transferable 對象 owner - 擁有剪貼簿內容的對象 拋出：IllegalStateException - 如果剪貼簿當前不可用 另請參見：Toolkit.getSystemClipboard()

getContents

public TransferablegetContents(Object requestor)返回表示剪貼簿當前內容的 transferable 對象。如果剪貼簿目前沒有任何內容，則返回 null。目前沒有使用參數 Object requestor。如果剪貼簿當前不可用，則該方法拋出 IllegalStateException。例如，在某些平台上，系統剪貼簿在被別的應用程式訪問時是不可用的。 參數：requestor - 請求剪下數據（不使用）的對象 返回：剪貼簿上的當前 transferable 拋出：IllegalStateException - 如果剪貼簿當前不可用 另請參見：Toolkit.getSystemClipboard()

getAvailableDataFlavors

public DataFlavor[] getAvailableDataFlavors()返回 DataFlavor 的數組，其中提供了此剪貼簿的當前內容。如果不存在任何可用的 DataFlavor，則此方法返回一個長度為零的數組。 返回：一組 DataFlavor，在其中可以提供此剪貼簿的當前內容 拋出：IllegalStateException - 如果此剪貼簿當前不可用 從以下版本開始：1.5

isDataFlavorAvailable

public boolean isDataFlavorAvailable(DataFlavor flavor)返回是否能夠以指定的 DataFlavor 形式提供此剪貼簿的當前內容。 參數：flavor - 為該內容請求的 DataFlavor返回：如果可以在指定的 DataFlavor 中提供此剪貼簿的當前內容，則返回 true；否則返回 false拋出：NullPointerException - 如果 flavor 為 nullIllegalStateException - 如果此剪貼簿當前不可用

從以下版本開始：1.5

getData

public ObjectgetData(DataFlavor flavor) throws UnsupportedFlavorException, IOException返回一個對象，表示此剪貼簿中指定 DataFlavor 類型的當前內容。返回對象的類是由 flavor 的表示形式類定義的。 參數：flavor - 為該內容請求的 DataFlavor返回：一個對象，表示指定的 DataFlavor 中此剪貼簿的當前內容 拋出：NullPointerException - 如果 flavor 為 nullIllegalStateException - 如果此剪貼簿目前不可用 UnsupportedFlavorException - 如果請求的 DataFlavor 不可用 IOException - 如果無法檢索請求的 DataFlavor 中的數據

從以下版本開始：1.5

另請參見：DataFlavor.getRepresentationClass()

addFlavorListener

public void addFlavorListener(FlavorListener listener)註冊指定的 FlavorListener，以從此剪貼簿接收 FlavorEvent。如果 listener 為 null，則不會拋出異常並且不執行操作。

參數：listener - 要添加的偵聽器 從

以下版本開始：1.5

另請參見：removeFlavorListener(java.awt.datatransfer.FlavorListener), getFlavorListeners(), FlavorListener, FlavorEvent

removeFlavorListener

public void removeFlavorListener(FlavorListener listener) 移除指定的 FlavorListener，使其不再從此 Clipboard 接收 FlavorEvent。如果參數所指定的偵聽器尚未添加到此 Clipboard，則此方法不起作用，也不拋出異常。如果 listener 為 null，則不會拋出異常並且不執行操作。

參數：listener - 要移除的偵聽器

從以下版本開始：1.5

另請參見：addFlavorListener(java.awt.datatransfer.FlavorListener), getFlavorListeners(), FlavorListener, FlavorEvent

getFlavorListeners

public FlavorListener[] getFlavorListeners()返回一組目前在此 Clipboard 上註冊的所有 FlavorListener。

返回：此剪貼簿的所有 FlavorListener，如果目前沒有註冊偵聽器，則返回一個空數組

從以下版本開始：1.5

另請參見：addFlavorListener(java.awt.datatransfer.FlavorListener), removeFlavorListener(java.awt.datatransfer.FlavorListener), FlavorListener, FlavorEvent