java.awt.dnd

クラスDropTargetDragEvent

java.lang.Object

java.util.EventObject

java.awt.dnd.DropTargetEvent

java.awt.dnd.DropTargetDragEvent

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

Serializable

public class DropTargetDragEvent
extends DropTargetEvent

DropTargetDragEventは、そのdragEnter()およびdragOver()メソッドによってDropTargetListenerに送られます。

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

ソース・ドロップ・アクションは、このドラッグ操作のドラッグ・ソースでサポートされている一連のドロップ・アクションを表す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

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

コンストラクタ

コンストラクタと説明
DropTargetDragEvent(DropTargetContext dtc, Point cursorLocn, int dropAction, int srcActions) この操作のDropTargetContext、Componentの座標内の「ドラッグ」Cursorのホット・スポットの位置、ユーザー・ドロップ・アクション、およびソース・ドロップ・アクションを使用して、DropTargetDragEventを構築します。

メソッドのサマリー

修飾子と型	メソッドと説明
void	acceptDrag(int dragOperation) ドラッグを受け入れます。
DataFlavor[]	getCurrentDataFlavors() このメソッドは、DropTargetContextから現在の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を返します。
void	rejectDrag() dropActionまたは使用可能なDataFlavorのタイプのどちらかを検査した結果としてドラッグを拒否します。

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

getDropTargetContext

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

getSource, toString

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

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

コンストラクタの詳細

DropTargetDragEvent

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

この操作のDropTargetContext、Componentの座標内の「ドラッグ」Cursorのホット・スポットの位置、ユーザー・ドロップ・アクション、およびソース・ドロップ・アクションを使用して、DropTargetDragEventを構築します。

パラメータ:

dtc - この操作のDropTargetContext

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

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

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

例外:

NullPointerException - cursorLocnがnullの場合

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

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

IllegalArgumentException - dtcがnullの場合。

メソッドの詳細

getLocation

public Point getLocation()

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

戻り値:

Componentの座標内の現在のカーソル位置。

getCurrentDataFlavors

public DataFlavor[] getCurrentDataFlavors()

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

戻り値:

DropTargetContextからの現在の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

例外:

InvalidDnDOperationException - ドラッグ操作に関連付けられたデータが使用できない場合

導入されたバージョン:

1.5

acceptDrag

public void acceptDrag(int dragOperation)

ドラッグを受け入れます。このメソッドは、実装でsrcActionsからdropActionで表された、ユーザーによって選択された操作以外の操作を受け入れるようにしたい場合に、DropTargetListenersのdragEnter、dragOver、およびdropActionChangedメソッドから呼び出すようにしてください。

パラメータ:

dragOperation - ターゲットによって受け入れられる操作

rejectDrag

public void rejectDrag()

dropActionまたは使用可能なDataFlavorのタイプのどちらかを検査した結果としてドラッグを拒否します。