public class Clipboard extends Object
ClipboardクラスのインスタンスにFlavorListener
を登録すると、このクリップボードで使用可能なDataFlavor
のセットへの変更に関する通知を受けることができます(addFlavorListener(java.awt.datatransfer.FlavorListener)
を参照してください)。
修飾子と型 | フィールドと説明 |
---|---|
protected Transferable |
contents |
protected ClipboardOwner |
owner |
修飾子と型 | メソッドと説明 |
---|---|
void |
addFlavorListener(FlavorListener listener)
このクリップボードから
FlavorEvent を受信するために、指定されたFlavorListener を登録します。 |
DataFlavor[] |
getAvailableDataFlavors()
このクリップボードの現在の内容を提供できる
DataFlavor の配列を返します。 |
Transferable |
getContents(Object requestor)
クリップボードの現在の内容を表現する転送可能なオブジェクトを返します。
|
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)
クリップボードの現在の内容を指定された転送可能なオブジェクトに設定し、指定されたクリップボード・オーナーを新しい内容のオーナーとして登録します。
|
protected ClipboardOwner owner
protected Transferable contents
public Clipboard(String name)
public String getName()
public void setContents(Transferable contents, ClipboardOwner owner)
引数owner
とは異なる既存のオーナーが存在する場合、そのオーナーには、そのオーナーのClipboardOwner.lostOwnership()
の呼出しによって、クリップボードの内容の所有権を失ったことが通知されます。setContents()
の実装は、このメソッドから直接lostOwnership()
を呼び出す必要はありません。たとえば、あとで別のスレッドでlostOwnership()
を呼び出すことができます。このクリップボードに登録されたFlavorListener
にも同じことがあてはまります。
このメソッドは、クリップボードが現在使用できない場合にIllegalStateException
をスローします。たとえば、プラットフォームによっては、ほかのアプリケーションがアクセスしている間はシステム・クリップボードが利用できない場合があります。
contents
- クリップボードの内容を表す転送可能なオブジェクトowner
- クリップボードの内容を所有するオブジェクトIllegalStateException
- クリップボードが現在使用できない場合Toolkit.getSystemClipboard()
public Transferable getContents(Object requestor)
null
を返します。パラメータObject要求者は現在使用されていません。このメソッドは、クリップボードが現在使用できない場合にIllegalStateException
をスローします。たとえば、プラットフォームによっては、ほかのアプリケーションがアクセスしている間はシステム・クリップボードが利用できない場合があります。requestor
- クリップ・データを要求しているオブジェクト(未使用)IllegalStateException
- クリップボードが現在使用できない場合Toolkit.getSystemClipboard()
public DataFlavor[] getAvailableDataFlavors()
DataFlavor
の配列を返します。使用可能なDataFlavor
が存在しない場合、このメソッドは長さゼロの配列を返します。DataFlavor
の配列IllegalStateException
- このクリップボードが現在使用できない場合public boolean isDataFlavorAvailable(DataFlavor flavor)
DataFlavor
でこのクリップボードの現在の内容を提供できるかどうかを返します。flavor
- 内容をリクエストされたDataFlavor
DataFlavor
で提供できる場合はtrue
。それ以外の場合はfalse
NullPointerException
- flavor
がnull
である場合IllegalStateException
- このクリップボードが現在使用できない場合public Object getData(DataFlavor flavor) throws UnsupportedFlavorException, IOException
DataFlavor
でこのクリップボードの現在の内容を表すオブジェクトを返します。返されるオブジェクトのクラスは、flavor
の表現クラスで定義されます。flavor
- 内容をリクエストされたDataFlavor
DataFlavor
でこのクリップボードの現在の内容を表すオブジェクトNullPointerException
- flavor
がnull
である場合IllegalStateException
- このクリップボードが現在使用できない場合UnsupportedFlavorException
- 要求されたDataFlavor
が使用できない場合IOException
- 要求されたDataFlavor
内のデータを取得できない場合DataFlavor.getRepresentationClass()
public void addFlavorListener(FlavorListener listener)
FlavorEvent
を受信するために、指定されたFlavorListener
を登録します。listener
がnull
である場合、例外はスローされず、何も処理は行われません。listener
- 追加されるリスナーremoveFlavorListener(java.awt.datatransfer.FlavorListener)
、getFlavorListeners()
、FlavorListener
、FlavorEvent
public void removeFlavorListener(FlavorListener listener)
FlavorListener
を削除して、このClipboard
からFlavorEvent
が受信されなくなるようにします。引数で指定されたリスナーが以前にこのClipboard
に追加されていない場合、このメソッドは何も実行せず、例外もスローしません。listener
がnull
である場合、例外はスローされず、何も処理は行われません。listener
- 削除されるリスナーaddFlavorListener(java.awt.datatransfer.FlavorListener)
、getFlavorListeners()
、FlavorListener
、FlavorEvent
public FlavorListener[] getFlavorListeners()
Clipboard
に現在登録されているすべてのFlavorListener
の配列を返します。FlavorListener
。または現在リスナーが登録されていない場合は空の配列addFlavorListener(java.awt.datatransfer.FlavorListener)
、removeFlavorListener(java.awt.datatransfer.FlavorListener)
、FlavorListener
、FlavorEvent
バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2016, Oracle and/or its affiliates. All rights reserved.Use is subject to license termsDocumentation Redistribution Policyも参照してください。