JavaTM 2 Platform
Standard Ed. 5.0

java.awt.dnd
クラス DropTargetContext

java.lang.Object
  上位を拡張 java.awt.dnd.DropTargetContext
すべての実装されたインタフェース:
Serializable

public class DropTargetContext
extends Object
implements Serializable

DropTargetContext は、ドラッグ&ドロップ操作に関連した論理カーソルが、DropTarget に関連した Component の可視ジオメトリと重なるときに、いつも作成されます。DropTargetContext は、ドロップ操作のレシーバがエンドユーザに適切なドラッグアンダーフィードバックを提供したり、必要に応じて後続のデータ転送を実行したりする機構を提供します。

導入されたバージョン:
1.2
関連項目:
直列化された形式

入れ子のクラスの概要
protected  class DropTargetContext.TransferableProxy
          TransferableProxyTransferable インタフェースを実装するヘルパー内部クラスで、特定のドラッグ&ドロップ操作のデータ転送を表す別の Transferable オブジェクトに対するプロキシとして動作します。
 
メソッドの概要
protected  void acceptDrag(int dragOperation)
          ドラッグを受け入れます。
protected  void acceptDrop(int dropOperation)
          指定された操作を使ってドロップが受け入れられることを知らせるために呼び出されます。
 void addNotify(java.awt.dnd.peer.DropTargetContextPeer dtcp)
          DropTargetContextPeer に関連したときに呼び出されます。
protected  Transferable createTransferableProxy(Transferable t, boolean local)
          指定された Transferable のプロキシとして TransferableProxy を作成します。
 void dropComplete(boolean success)
          このメソッドは、ドロップが完了したこと、およびそれが成功したかどうかを知らせます。
 Component getComponent()
          このメソッドは、この DropTargetContext に関連した Component を返します。
protected  DataFlavor[] getCurrentDataFlavors()
          この操作の Transferable オペランドの有効な DataFlavor を取得します。
protected  List<DataFlavor> getCurrentDataFlavorsAsList()
          このメソッドは、Transferable オペランドの現在有効な DataFlavor を java.util.List として返します。
 DropTarget getDropTarget()
          このメソッドは、この DropTargetContext に関連した DropTarget を返します。
protected  int getTargetActions()
          このメソッドは、この DropTarget が受け入れる現在のアクションを表す int を返します。
protected  Transferable getTransferable()
          この操作の Transferable (プロキシ) オペランドを返します。
protected  boolean isDataFlavorSupported(DataFlavor df)
          このメソッドは、指定した DataFlavor がこの DropTargetContext によってサポートされるかどうかを示す boolean を返します。
protected  void rejectDrag()
          ドラッグを拒否します。
protected  void rejectDrop()
          ドロップが受け入れられないことを知らせるために呼び出されます。
 void removeNotify()
          DropTargetContextPeer との関連が解かれるときに呼び出されます。
protected  void setTargetActions(int actions)
          このメソッドは、この DropTarget で許容される現在のアクションを設定します。
 
クラス java.lang.Object から継承されたメソッド
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

メソッドの詳細

getDropTarget

public DropTarget getDropTarget()
このメソッドは、この DropTargetContext に関連した DropTarget を返します。

戻り値:
この DropTargetContext に関連した DropTarget

getComponent

public Component getComponent()
このメソッドは、この DropTargetContext に関連した Component を返します。

戻り値:
この Context に関連した Component

addNotify

public void addNotify(java.awt.dnd.peer.DropTargetContextPeer dtcp)
DropTargetContextPeer に関連したときに呼び出されます。

パラメータ:
dtcp - DropTargetContextPeer

removeNotify

public void removeNotify()
DropTargetContextPeer との関連が解かれるときに呼び出されます。


setTargetActions

protected void setTargetActions(int actions)
このメソッドは、この DropTarget で許容される現在のアクションを設定します。

パラメータ:
actions - サポートされるアクションを表す int

getTargetActions

protected int getTargetActions()
このメソッドは、この DropTarget が受け入れる現在のアクションを表す int を返します。

戻り値:
この DropTarget で許容される現在のアクション

dropComplete

public void dropComplete(boolean success)
                  throws InvalidDnDOperationException
このメソッドは、ドロップが完了したこと、およびそれが成功したかどうかを知らせます。

パラメータ:
success - 成功した場合は true、そうでない場合は false

例外:
InvalidDnDOperationException - ドロップが未処理でないか、現存していない場合

acceptDrag

protected void acceptDrag(int dragOperation)
ドラッグを受け入れます。

パラメータ:
dragOperation - サポートされるアクション

rejectDrag

protected void rejectDrag()
ドラッグを拒否します。


acceptDrop

protected void acceptDrop(int dropOperation)
指定された操作を使ってドロップが受け入れられることを知らせるために呼び出されます。DropTargetListener.drop メソッドの呼び出しの間に呼び出される必要があります。

パラメータ:
dropOperation - サポートされるアクション

rejectDrop

protected void rejectDrop()
ドロップが受け入れられないことを知らせるために呼び出されます。DropTargetListener.drop メソッドの呼び出しの間に呼び出される必要があります。


getCurrentDataFlavors

protected DataFlavor[] getCurrentDataFlavors()
この操作の Transferable オペランドの有効な DataFlavor を取得します。

戻り値:
Transferable オペランドの、サポートされる DataFlavor を格納する DataFlavor[]

getCurrentDataFlavorsAsList

protected List<DataFlavor> getCurrentDataFlavorsAsList()
このメソッドは、Transferable オペランドの現在有効な DataFlavor を java.util.List として返します。

戻り値:
java.util.List として現在有効な DataFlavor

isDataFlavorSupported

protected boolean isDataFlavorSupported(DataFlavor df)
このメソッドは、指定した DataFlavor がこの DropTargetContext によってサポートされるかどうかを示す boolean を返します。

パラメータ:
df - DataFlavor

戻り値:
指定された DataFlavor がサポートされているかどうか

getTransferable

protected Transferable getTransferable()
                                throws InvalidDnDOperationException
この操作の Transferable (プロキシ) オペランドを返します。

戻り値:
Transferable
例外:
InvalidDnDOperationException - ドラッグが未処理でないか、現存していない場合


createTransferableProxy

protected Transferable createTransferableProxy(Transferable t,
                                               boolean local)
指定された Transferable のプロキシとして TransferableProxy を作成します。

パラメータ:
t - プロキシの対象の Transferable
local - t がローカルのドラッグ&ドロップ操作の結果を表す場合は true
戻り値:
新しい TransferableProxy インスタンス

JavaTM 2 Platform
Standard Ed. 5.0

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

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