- 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にあるかどうか
-
-