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 - この所有者がクリップボードに配置した内容