モジュール java.desktop

パッケージ java.awt.dnd

クラスDropTargetContext

java.lang.Object

java.awt.dnd.DropTargetContext

すべての実装されたインタフェース:

Serializable

public final class DropTargetContext extends Object implements Serializable

ドラッグ&ドロップ操作に関連付けられた論理カーソルが、DropTargetに関連付けられたComponentの可視幾何学的図形と重なった場合は常に、DropTargetContextが作成されます。 DropTargetContextは、ドロップ操作のレシーバがエンド・ユーザーに適切なドラッグ・アンダー・フィードバックを提供したり、必要に応じて後続のデータ転送を実行したりするメカニズムを提供します。

導入されたバージョン:

1.2

関連項目:

• 直列化された形式

ネストされたクラスのサマリー

ネストされたクラス

修飾子と型	クラス	説明
protected class	DropTargetContext.TransferableProxy	TransferableProxyは、Transferableインタフェースを実装するヘルパー内部クラスであり、特定のドラッグ&ドロップ操作のデータ転送を表す別のTransferableオブジェクトのためのプロキシとして機能します。

メソッドのサマリー

修飾子と型	メソッド	説明
protected void	acceptDrag(int dragOperation)	ドラッグを受け入れます。
protected void	acceptDrop(int dropOperation)	指定された操作を使ってドロップが受け入れられることを知らせるために呼び出されます。
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オペランドの現在使用可能なDataFlavorsを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()	ドロップが受け入れられないことを知らせるために呼び出されます。
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

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オペランドの現在使用可能なDataFlavorsを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インスタンス。