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[]
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
-
コンストラクタの詳細
-
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にあるかどうか
-