java.awt.datatransfer
類別 Clipboard

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 物件，並將指定的剪貼板所有者作為新內容的所有者註冊。

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

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

欄位詳細資訊

owner

protected ClipboardOwner owner

contents

protected Transferable contents

建構子詳細資訊

Clipboard

public Clipboard(String name)

創建剪貼板物件。

另請參見：

Toolkit.getSystemClipboard()

方法詳細資訊

getName

public String getName()

返回此剪貼板物件的名稱。

另請參見：

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 Transferable getContents(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 為 null

IllegalStateException - 如果此剪貼板當前不可用

從以下版本開始：

1.5

getData

public Object getData(DataFlavor flavor)
               throws UnsupportedFlavorException,
                      IOException

返回一個物件，表示此剪貼板中指定 DataFlavor 型別的當前內容。返回物件的類別是由 flavor 的表示形式類別定義的。

參數：

flavor - 為該內容請求的 DataFlavor

返回：

一個物件，表示指定的 DataFlavor 中此剪貼板的當前內容

拋出：

NullPointerException - 如果 flavor 為 null

IllegalStateException - 如果此剪貼板目前不可用

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