java.awt.dnd

クラス DropTargetDropEvent

java.lang.Object

java.util.EventObject

java.awt.dnd.DropTargetEvent

java.awt.dnd.DropTargetDropEvent

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

Serializable

public class DropTargetDropEvent
extends DropTargetEvent

DropTargetDropEvent は、DropTargetListener の drop() メソッドによって送られます。

DropTargetDropEvent は、ドラッグ&ドロップ操作の現在の状態が反映されたソースドロップアクションとユーザードロップアクションを報告します。

ソースドロップアクションは、このドラッグ&ドロップ操作のドラッグソースでサポートされている一連のドロップアクションを表す DnDConstants のビット単位のマスクです。

ユーザードロップアクションは、ドラッグソースでサポートされているドロップアクションと、ユーザーによって選択されたドロップアクションによって異なります。ユーザーは、ドラッグ操作中に修飾キーを押すことで、ドロップアクションを選択できます。

   Ctrl + Shift -> ACTION_LINK
   Ctrl         -> ACTION_COPY
   Shift        -> ACTION_MOVE
 

ユーザーがドロップアクションを選択した場合、ユーザードロップアクションは、このドロップアクションがドラッグソースでサポートされている場合は選択されたドロップアクションを表す DnDConstants のいずれか、このドロップアクションがドラッグソースでサポートされていない場合は DnDConstants.ACTION_NONE です。

ユーザーがドロップアクションを選択しない場合、ドラッグソースでサポートされている一連のドロップアクションを表す DnDConstants のセットから DnDConstants.ACTION_MOVE、DnDConstants.ACTION_COPY、DnDConstants.ACTION_LINK が順に検索され、ユーザードロップアクションは最初に見つかった定数です。どの定数も見つからなかった場合、ユーザードロップアクションは DnDConstants.ACTION_NONE です。

導入されたバージョン:

1.2

関連項目:

直列化された形式

フィールドのサマリー

クラス java.awt.dnd.DropTargetEvent から継承されたフィールド

context

クラス java.util.EventObject から継承されたフィールド

source

コンストラクタのサマリー

コンストラクタ

コンストラクタと説明
DropTargetDropEvent(DropTargetContext dtc, Point cursorLocn, int dropAction, int srcActions) この操作の DropTargetContext、Component の座標内のドラッグ Cursor のホットスポットの位置、現在選択されているユーザードロップアクション、およびソースでサポートされている現在のアクションのセットを使用して、DropTargetDropEvent を構築します。
DropTargetDropEvent(DropTargetContext dtc, Point cursorLocn, int dropAction, int srcActions, boolean isLocal) この操作の DropTargetContext、Component の座標内のドラッグ Cursor のホットスポットの位置、現在選択されているユーザードロップアクション、ソースでサポートされている現在のアクションのセット、およびソースがターゲットと同じ JVM 内に存在するかどうかを示す boolean を使用して、DropTargetEvent を構築します。

メソッドのサマリー

メソッド

修飾子と型	メソッドと説明
void	acceptDrop(int dropAction) 指定されたアクションを使って、ドロップを受け入れます。
void	dropComplete(boolean success) このメソッドは、ドロップ転送が完了したことを DragSource に通知します。
DataFlavor[]	getCurrentDataFlavors() このメソッドは、現在の DataFlavor を返します。
List<DataFlavor>	getCurrentDataFlavorsAsList() このメソッドは、現在使用可能な DataFlavor を java.util.List として返します。
int	getDropAction() このメソッドは、ユーザードロップアクションを返します。
Point	getLocation() このメソッドは、Component の座標内の Cursor の現在の位置を示す Point を返します。
int	getSourceActions() このメソッドは、ソースドロップアクションを返します。
Transferable	getTransferable() このメソッドは、ドロップに関連付けられた Transferable オブジェクトを返します。
boolean	isDataFlavorSupported(DataFlavor df) このメソッドは、指定された DataFlavor がソースから使用可能かどうかを示す boolean を返します。
boolean	isLocalTransfer() このメソッドは、ソースがターゲットと同じ JVM 内に存在するかどうかを示す int を返します。
void	rejectDrop() ドロップを拒否します。

クラス java.awt.dnd.DropTargetEvent から継承されたメソッド

getDropTargetContext

クラス java.util.EventObject から継承されたメソッド

getSource, toString

クラス java.lang.Object から継承されたメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

コンストラクタの詳細

DropTargetDropEvent

public DropTargetDropEvent(DropTargetContext dtc,
                   Point cursorLocn,
                   int dropAction,
                   int srcActions)

この操作の DropTargetContext、Component の座標内のドラッグ Cursor のホットスポットの位置、現在選択されているユーザードロップアクション、およびソースでサポートされている現在のアクションのセットを使用して、DropTargetDropEvent を構築します。デフォルトでは、このコンストラクタはターゲットがソースと同じ仮想マシン内にないことを前提にしています。つまり、isLocalTransfer() は false を返します。

パラメータ:

dtc - この操作の DropTargetContext

cursorLocn - Component 座標内の「ドラッグ」カーソルのホットスポットの位置

dropAction - ユーザードロップアクション。

srcActions - ソースドロップアクション。

例外:

NullPointerException - cursorLocn が次の場合 null

IllegalArgumentException - dropAction が DnDConstants のいずれでもない場合。

IllegalArgumentException - srcActions が DnDConstants のビット単位のマスクでない場合。

IllegalArgumentException - dtc が null の場合。

DropTargetDropEvent

public DropTargetDropEvent(DropTargetContext dtc,
                   Point cursorLocn,
                   int dropAction,
                   int srcActions,
                   boolean isLocal)

この操作の DropTargetContext、Component の座標内のドラッグ Cursor のホットスポットの位置、現在選択されているユーザードロップアクション、ソースでサポートされている現在のアクションのセット、およびソースがターゲットと同じ JVM 内に存在するかどうかを示す boolean を使用して、DropTargetEvent を構築します。

パラメータ:

dtc - この操作の DropTargetContext

cursorLocn - Component の座標内の「ドラッグ」カーソルのホットスポットの位置

dropAction - ユーザードロップアクション。

srcActions - ソースドロップアクション。

isLocal - ソースがターゲットと同じ JVM 内にある場合は true

例外:

NullPointerException - cursorLocn が次の場合 null

IllegalArgumentException - dropAction が DnDConstants のいずれでもない場合。

IllegalArgumentException - srcActions が DnDConstants のビット単位のマスクでない場合。

IllegalArgumentException - dtc が null の場合。

メソッドの詳細

getLocation

public Point getLocation()

このメソッドは、Component の座標内の Cursor の現在の位置を示す Point を返します。

戻り値:

Component の座標内の現在の Cursor の位置。

getCurrentDataFlavors

public DataFlavor[] getCurrentDataFlavors()

このメソッドは、現在の DataFlavor を返します。

戻り値:

現在の DataFlavor

getCurrentDataFlavorsAsList

public List<DataFlavor> getCurrentDataFlavorsAsList()

このメソッドは、現在使用可能な DataFlavor を java.util.List として返します。

戻り値:

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

isDataFlavorSupported

public boolean isDataFlavorSupported(DataFlavor df)

このメソッドは、指定された DataFlavor がソースから使用可能かどうかを示す boolean を返します。

パラメータ:

df - テストする DataFlavor

戻り値:

指定された DataFlavor がソースで有効な場合

getSourceActions

public int getSourceActions()

このメソッドは、ソースドロップアクションを返します。

戻り値:

ソースドロップアクション

getDropAction

public int getDropAction()

このメソッドは、ユーザードロップアクションを返します。

戻り値:

ユーザードロップアクション

getTransferable

public Transferable getTransferable()

このメソッドは、ドロップに関連付けられた Transferable オブジェクトを返します。

戻り値:

ドロップに関連付けられた Transferable

acceptDrop

public void acceptDrop(int dropAction)

指定されたアクションを使って、ドロップを受け入れます。

パラメータ:

dropAction - 指定されたアクション

rejectDrop

public void rejectDrop()

ドロップを拒否します。

dropComplete

public void dropComplete(boolean success)

このメソッドは、ドロップ転送が完了したことを DragSource に通知します。

パラメータ:

success - ドロップ転送が完了したことを示す boolean。

isLocalTransfer

public boolean isLocalTransfer()

このメソッドは、ソースがターゲットと同じ JVM 内に存在するかどうかを示す int を返します。

戻り値:

Source が同じ JVM にあるかどうか