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) ドラッグを受け入れます。このメソッドは、DropTargetContext
から現在のDataFlavor
を返します。このメソッドは、現在のDataFlavor
をjava.util.List
として返します。int
このメソッドは、ユーザー・ドロップ・アクションを返します。このメソッドは、Component
の座標内のCursor
の現在の位置を示すPoint
を返します。int
このメソッドは、ソース・ドロップ・アクションを返します。このメソッドは、現在のドラッグ操作に関連したデータを表すTransferableオブジェクトを返します。boolean
このメソッドは、指定されたDataFlavor
がサポートされているかどうかを示すboolean
を返します。void
dropAction
または使用可能なDataFlavor
のタイプのどちらかを検査した結果としてドラッグを拒否します。クラス java.awt.dnd.DropTargetEventで宣言されたメソッド
getDropTargetContext
クラス java.util.EventObjectで宣言されたメソッド
getSource, toString
-
コンストラクタの詳細
-
DropTargetDragEvent
public DropTargetDragEvent(DropTargetContext dtc, Point cursorLocn, int dropAction, int srcActions) この操作のDropTargetContext
、Component
の座標内の「ドラッグ」Cursor
のホット・スポットの位置、ユーザー・ドロップ・アクション、およびソース・ドロップ・アクションを使用して、DropTargetDragEvent
を構築します。- パラメータ:
dtc
- この操作のDropTargetContextcursorLocn
- 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
のタイプのどちらかを検査した結果としてドラッグを拒否します。
-