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 の 1 つです。そのドロップアクションがドラッグソースでサポートされていなければ、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 にあるかどうか