- 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
-
-
-
-
コンストラクタの詳細
-
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
のタイプのどちらかを検査した結果としてドラッグを拒否します。
-
-