モジュール java.datatransfer

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

導入されたバージョン:

1.1

関連項目:

• 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を作成します。

パラメータ:

data - 転送される文字列

メソッドの詳細

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が上記の味の1つでない場合、false

例外:

NullPointerException - flavorが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 - flavorがnullである場合

関連項目:

• Reader

lostOwnership

public void lostOwnership(Clipboard clipboard, Transferable contents)

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

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

定義:

lostOwnership、インタフェースClipboardOwner

パラメータ:

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

contents - この所有者がclipboardに配置したコンテンツ