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を返します。このメソッドは、現在使用可能なDataFlavor
をjava.util.List
として返します。int
このメソッドは、ユーザー・ドロップ・アクションを返します。このメソッドは、Component
の座標内のCursor
の現在の位置を示すPoint
を返します。int
このメソッドは、ソース・ドロップ・アクションを返します。このメソッドは、ドロップに関連付けられたTransferable
オブジェクトを返します。boolean
このメソッドは、指定されたDataFlavor
がソースから使用可能かどうかを示すboolean
を返します。boolean
このメソッドは、ソースがターゲットと同じJVM内に存在するかどうかを示すint
を返します。void
ドロップを拒否します。クラス java.awt.dnd.DropTargetEventで宣言されたメソッド
getDropTargetContext
クラス java.util.EventObjectで宣言されたメソッド
getSource, toString
-
コンストラクタの詳細
-
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
- この操作のDropTargetContextcursorLocn
- 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にあるかどうか
-