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 TransferableProxy は Transferable インタフェースを実装するヘルパー内部クラスで、特定のドラッグ＆ドロップ操作のデータ転送を表す別の 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 として返します。

戻り値:

現在の有効な DataFlavor の java.util.List

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 インスタンス