java.awt.datatransfer
クラス StringSelection

java.lang.Object
  java.awt.datatransfer.StringSelection

すべての実装されたインタフェース:

ClipboardOwner, Transferable

public class StringSelection
extends Object
implements Transferable, ClipboardOwner

String を転送する際に必要な能力を実装する Transferable です。 Transferable は、DataFlavor.stringFlavor とすべての同等なフレーバを適切にサポートします。DataFlavor.plainTextFlavor およびすべての同等なフレーバのサポートは推奨されません。ほかの DataFlavor はサポートされません。

関連項目:

DataFlavor.stringFlavor, DataFlavor.plainTextFlavor

コンストラクタの概要

StringSelection(String data)
指定した String を転送可能な Transferable を作成します。

メソッドの概要

Object	getTransferData(DataFlavor flavor) 可能であれば、要求された DataFlavor の Transferable データを返します。
DataFlavor[]	getTransferDataFlavors() この Transferable がデータを提供できるフレーバの配列を返します。
boolean	isDataFlavorSupported(DataFlavor 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()

この Transferable がデータを提供できるフレーバの配列を返します。DataFlavor.stringFlavor が適切にサポートされます。DataFlavor.plainTextFlavor のサポートは推奨されません。

定義:

インタフェース Transferable 内の getTransferDataFlavors

戻り値:

要素が DataFlavor. stringFlavor と DataFlavor.plainTextFlavor の 2 つの長さの配列

isDataFlavorSupported

public boolean isDataFlavorSupported(DataFlavor flavor)

要求したフレーバが、この Transferable でサポートされているかどうかを返します。

定義:

インタフェース Transferable 内の isDataFlavorSupported

パラメータ:

flavor - データに対して要求されたフレーバ

戻り値:

flavor が DataFlavor.stringFlavor か DataFlavor.plainTextFlavor と等しい場合は true、それ以外の flavor の場合は false

例外:

NullPointerException - フレーバが null の場合

getTransferData

public Object getTransferData(DataFlavor flavor)
                       throws UnsupportedFlavorException,
                              IOException

可能であれば、要求された DataFlavor の Transferable データを返します。要求したフレーバが DataFlavor.stringFlavor または同等のフレーバの場合、選択を表す String を返します。要求したフレーバが、DataFlavor.plainTextFlavor または同等のフレーバの場合は、Reader を返します。注: このメソッドの DataFlavor.plainTextFlavor および同等の DataFlavor の動作は DataFlavor.plainTextFlavor の定義と異なります。

定義:

インタフェース Transferable 内の getTransferData

パラメータ:

flavor - データに対して要求されたフレーバ

戻り値:

要求したフレーバのデータ (上記を参照)

例外:

UnsupportedFlavorException - 要求したデータフレーバが DataFlavor.stringFlavor または DataFlavor.plainTextFlavor と異なる場合

IOException - データの取得中に IOException が発生した場合。デフォルトでは、StringSelection がこの例外をスローすることはないが、サブクラスではスローすることがある

NullPointerException - フレーバが null の場合

関連項目:

Reader

lostOwnership

public void lostOwnership(Clipboard clipboard,
                          Transferable contents)

インタフェース ClipboardOwner の記述:

クリップボードのオーナではなくなったことを、このオブジェクトに通知します。別のアプリケーションまたはこのアプリケーション内の別のオブジェクトがこのクリップボードの所有権を表明すると、このメソッドが呼び出されます。

定義:

インタフェース ClipboardOwner 内の lostOwnership

パラメータ:

clipboard - もう所有されていないクリップボード

contents - このオーナが所有していたクリップボード上の内容