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 のサポートは非推奨です。

定義:

getTransferDataFlavors、インタフェース: Transferable

戻り値:

要素が DataFlavor. stringFlavor と DataFlavor.plainTextFlavor である長さ 2 の配列

isDataFlavorSupported

public boolean isDataFlavorSupported(DataFlavor flavor)

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

定義:

isDataFlavorSupported、インタフェース: Transferable

パラメータ:

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 の定義と一貫性がありません。

定義:

getTransferData、インタフェース: Transferable

パラメータ:

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

戻り値:

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

例外:

UnsupportedFlavorException - 要求されたデータフレーバが DataFlavor.stringFlavor または DataFlavor.plainTextFlavor のどちらとも同等ではない場合

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

NullPointerException - - フレーバが null である場合

関連項目:

Reader

lostOwnership

public void lostOwnership(Clipboard clipboard,
                 Transferable contents)

インタフェースからコピーされた説明: ClipboardOwner

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

定義:

lostOwnership、インタフェース: ClipboardOwner

パラメータ:

clipboard - 所有されなくなったクリップボード

contents - この所有者がクリップボードに配置した内容