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 はサポートされていません。

関連項目:

java.awt.datatransfer.DataFlavor.stringFlavor, java.awt.datatransfer.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 - このオーナが所有していたクリップボード上の内容