java.awt.dnd
クラス DropTargetContext

java.lang.Object
  |
  +--java.awt.dnd.DropTargetContext

public class DropTargetContext

extends Object

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

導入されたバージョン:

1.2

内部クラスの概要

protected class

DropTargetContext.TransferableProxy TransferableProxy は、データ変換の管理で DropTargetContext をサポートする、入れ子のヘルパークラスです。

メソッドの概要

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) サブクラスは、独自の Proxy Transferable を提供するために、このメソッドをオーバーライドできます。
void	dropComplete(boolean success) このメソッドは、ドロップが完了したこと、およびそれが成功したかどうかを知らせます。
Component	getComponent() このメソッドは、この DropTargetContext に関連した Component を返します。
protected DataFlavor[]	getCurrentDataFlavors() この操作の Transferable オペランドの有効な DataFlavor を取得します。
protected List	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 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)

サブクラスは、独自の Proxy Transferable を提供するために、このメソッドをオーバーライドできます。

パラメータ:

t - Transferable

local - boolean 型

戻り値:

Transferable