java.lang.Object
java.awt.datatransfer.Clipboard
public class Clipboard extends Object
カット/コピー/ペースト操作を使用してデータを転送するメカニズムを実装するクラスです。
ClipboardクラスのインスタンスにFlavorListener
を登録すると、このクリップボードで使用可能なDataFlavor
のセットへの変更に関する通知を受けることができます(addFlavorListener(java.awt.datatransfer.FlavorListener)
を参照してください)。
- 導入されたバージョン:
- 1.1
- 関連項目:
-
フィールドのサマリー
-
コンストラクタのサマリー
-
メソッドのサマリー
修飾子と型メソッド説明void
addFlavorListener
(FlavorListener listener) このクリップボードからFlavorEvent
を受信するために、指定されたFlavorListener
を登録します。このクリップボードの現在の内容を提供できるDataFlavor
の配列を返します。getContents
(Object requestor) クリップボードの現在の内容を表現する転送可能なオブジェクトを返します。getData
(DataFlavor flavor) 指定されたDataFlavor
でこのクリップボードの現在の内容を表すオブジェクトを返します。このClipboard
に現在登録されているすべてのFlavorListener
の配列を返します。getName()
クリップボード・オブジェクトの名前を返します。boolean
isDataFlavorAvailable
(DataFlavor flavor) 指定されたDataFlavor
でこのクリップボードの現在の内容を提供できるかどうかを返します。void
removeFlavorListener
(FlavorListener listener) 指定されたFlavorListener
を削除して、このClipboard
からFlavorEvent
が受信されなくなるようにします。void
setContents
(Transferable contents, ClipboardOwner owner) クリップボードの現在の内容を指定された転送可能なオブジェクトに設定し、指定されたクリップボード・オーナーを新しい内容のオーナーとして登録します。
-
フィールド詳細
-
owner
protected ClipboardOwner ownerクリップボードの所有者。 -
contents
protected Transferable contentsクリップボードの内容。
-
-
コンストラクタの詳細
-
Clipboard
public Clipboard(String name) クリップボード・オブジェクトを作成します。- パラメータ:
name
- クリップボード用- 関連項目:
-
-
メソッドの詳細
-
getName
public String getName()クリップボード・オブジェクトの名前を返します。- 戻り値:
- このクリップボード・オブジェクトの名前
- 関連項目:
-
setContents
public void setContents(Transferable contents, ClipboardOwner owner) クリップボードの現在の内容を指定された転送可能なオブジェクトに設定し、指定されたクリップボード・オーナーを新しい内容のオーナーとして登録します。引数
owner
とは異なる既存のオーナーが存在する場合、そのオーナーには、そのオーナーのClipboardOwner.lostOwnership()
の呼出しによって、クリップボードの内容の所有権を失ったことが通知されます。setContents()
の実装は、このメソッドから直接lostOwnership()
を呼び出す必要はありません。 たとえば、あとで別のスレッドでlostOwnership()
を呼び出すことができます。 このクリップボードに登録されたFlavorListener
にも同じことがあてはまります。このメソッドは、クリップボードが現在使用できない場合に
IllegalStateException
をスローします。 たとえば、プラットフォームによっては、ほかのアプリケーションがアクセスしている間はシステム・クリップボードが利用できない場合があります。- パラメータ:
contents
- クリップボードの内容を表す転送可能なオブジェクトowner
- クリップボードの内容を所有するオブジェクト- 例外:
IllegalStateException
- クリップボードが現在使用できない場合- 関連項目:
-
getContents
public Transferable getContents(Object requestor) クリップボードの現在の内容を表現する転送可能なオブジェクトを返します。 現在クリップボードに内容がない場合は、null
を返します。 パラメータObject要求者は現在使用されていません。 このメソッドは、クリップボードが現在使用できない場合にIllegalStateException
をスローします。 たとえば、プラットフォームによっては、ほかのアプリケーションがアクセスしている間はシステム・クリップボードが利用できない場合があります。- パラメータ:
requestor
- クリップ・データを要求しているオブジェクト(未使用)- 戻り値:
- クリップボード上の現在の転送可能なオブジェクト
- 例外:
IllegalStateException
- クリップボードが現在使用できない場合- 関連項目:
-
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
- 関連項目:
-
addFlavorListener
public void addFlavorListener(FlavorListener listener) このクリップボードからFlavorEvent
を受信するために、指定されたFlavorListener
を登録します。listener
がnull
である場合、例外はスローされず、何も処理は行われません。- パラメータ:
listener
- 追加されるリスナー- 導入されたバージョン:
- 1.5
- 関連項目:
-
removeFlavorListener
public void removeFlavorListener(FlavorListener listener) 指定されたFlavorListener
を削除して、このClipboard
からFlavorEvent
が受信されなくなるようにします。 引数で指定されたリスナーが以前にこのClipboard
に追加されていない場合、このメソッドは何も実行せず、例外もスローしません。listener
がnull
である場合、例外はスローされず、何も処理は行われません。- パラメータ:
listener
- 削除されるリスナー- 導入されたバージョン:
- 1.5
- 関連項目:
-
getFlavorListeners
public FlavorListener[] getFlavorListeners()このClipboard
に現在登録されているすべてのFlavorListener
の配列を返します。- 戻り値:
- このクリップボードのすべての
FlavorListener
。または現在リスナーが登録されていない場合は空の配列 - 導入されたバージョン:
- 1.5
- 関連項目:
-