JavaTM Platform
Standard Ed. 6

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)
          可能であれば、要求された DataFlavorTransferable データを返します。
 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.stringFlavorDataFlavor.plainTextFlavor を持つ 長さ 2 の配列

isDataFlavorSupported

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

定義:
インタフェース Transferable 内の isDataFlavorSupported
パラメータ:
flavor - データに対して要求されたフレーバ
戻り値:
flavorDataFlavor.stringFlavor または DataFlavor.plainTextFlavor と等しい場合は true、 それ以外の flavor の場合は false
例外:
NullPointerException - フレーバが null の場合

getTransferData

public Object getTransferData(DataFlavor flavor)
                       throws UnsupportedFlavorException,
                              IOException
可能であれば、要求された DataFlavorTransferable データを返します。要求したフレーバが 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 - このオーナが所有していたクリップボード上の内容

JavaTM Platform
Standard Ed. 6

バグの報告と機能のリクエスト
さらに詳しい API リファレンスおよび開発者ドキュメントについては、Java SE 開発者用ドキュメントを参照してください。開発者向けの詳細な解説、概念の概要、用語の定義、バグの回避策、およびコード実例が含まれています。

Copyright 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Documentation Redistribution Policy も参照してください。