java.awt.dnd
類別 DropTargetDropEvent

java.lang.Object
  java.util.EventObject
      java.awt.dnd.DropTargetEvent
          java.awt.dnd.DropTargetDropEvent

所有已實作的介面：

Serializable

public class DropTargetDropEvent
extends DropTargetEvent

通過 DropTargetListener drop() 方法發送 DropTargetDropEvent。

DropTargetDropEvent 報告源 drop 操作 和使用者 drop 操作，這些操作反映了 drag-and-drop 操作的當前狀態。

源 drop 操作 是 DnDConstants 的位遮罩碼，DnDConstants 表示受 drag-and-drop 操作的 drag 源支持的 drop 操作集合。

使用者 drop 操作 取決於受 drag 源支持的 drop 操作和使用者選定的 drop 操作。在進行 drag 操作中，使用者可以通過按下修正鍵選擇一個 drop 操作。

 
   Ctrl + Shift -> ACTION_LINK
   Ctrl         -> ACTION_COPY
   Shift        -> ACTION_MOVE

當使用者選擇一個 drop 操作時，如果此 drop 操作受 drag 源支持，則使用者 drop 操作 為表示選擇的 drop 操作 DnDConstants 之一，如果此 drop 操作不受 drag 源支持，則使用者 drop 操作為 DnDConstants.ACTION_NONE 之一。

如果使用者沒有選 drop 操作，則表示受 drag 源支持的 drop 操作集合的 DnDConstants 集合是先搜尋 DnDConstants.ACTION_MOVE，然後搜尋 DnDConstants.ACTION_COPY，最後搜尋 DnDConstants.ACTION_LINK 而得到的，並且使用者 drop 操作 是找到的第一個常數。如果找不到常數，則使用者 drop 操作 為 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 坐標中 drag Cursor 的熱點位置、目前選擇的使用者 drop 操作和當前受源物件支持的操作集合的情況下，建構一個 DropTargetDropEvent。

DropTargetDropEvent(DropTargetContext dtc, Point cursorLocn, int dropAction, int srcActions, boolean isLocal)
在給出此操作的 DropTargetContext、Component 的坐標中 drag Cursor 的熱點位置、目前選擇的使用者 drop 操作、當前受源物件支持的操作集合，以及一個指示源對象與目標物件是否在同一 JVM 中的 boolean 值的情況下，建構一個 DropTargetEvent。

方法摘要

void	acceptDrop(int dropAction) 使用指定的操作接受 drop。
void	dropComplete(boolean success) 此方法通知 DragSource drop 傳輸已完成。
DataFlavor[]	getCurrentDataFlavors() 此方法返回當前的 DataFlavor。
List<DataFlavor>	getCurrentDataFlavorsAsList() 此方法以 java.util.List 形式返回當前可用的 DataFlavor。
int	getDropAction() 此方法返回使用者 drop 操作。
Point	getLocation() 此方法返回一個 Point，指示 Component 坐標中 Cursor 的當前位置。
int	getSourceActions() 此方法返回源 drop 操作。
Transferable	getTransferable() 此方法返回與 drop 相關的 Transferable 物件。
boolean	isDataFlavorSupported(DataFlavor df) 此方法返回一個指示指定的 DataFlavor 是否可在源物件中使用的 boolean 值。
boolean	isLocalTransfer() 此方法返回一個指示源對象與目標物件是否在同一 JVM 中的 int。
void	rejectDrop() 拒絕 Drop。

從類別 java.awt.dnd.DropTargetEvent 繼承的方法

getDropTargetContext

從類別 java.util.EventObject 繼承的方法

getSource, toString

從類別 java.lang.Object 繼承的方法

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

建構子詳細資訊

DropTargetDropEvent

public DropTargetDropEvent(DropTargetContext dtc,
                           Point cursorLocn,
                           int dropAction,
                           int srcActions)

在給出此操作的 DropTargetContext、Component 坐標中 drag Cursor 的熱點位置、目前選擇的使用者 drop 操作和當前受源物件支持的操作集合的情況下，建構一個 DropTargetDropEvent。預設情況下，此建構器假定目標對象與源物件不在同一虛擬機器中；也就是說，isLocalTransfer() 將返回 false。

參數：

dtc - 此操作的 DropTargetContext

cursorLocn - Component 坐標中 "Drag" Cursor 的熱點位置

dropAction - 使用者 drop 操作。

srcActions - 源 drop 操作。

拋出：

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 的坐標中 drag Cursor 的熱點位置、目前選擇的使用者 drop 操作、當前受源物件支持的操作集合，以及一個指示源對象與目標物件是否在同一 JVM 中的 boolean 值的情況下，建構一個 DropTargetEvent。

參數：

dtc - 此操作的 DropTargetContext

cursorLocn - Component 坐標中 "Drag" Cursor 的熱點位置

dropAction - 使用者 drop 操作。

srcActions - 源 drop 操作。

isLocal - 如果源對象與目標物件在同一 JVM 中，則為 true

拋出：

NullPointerException - 如果 cursorLocn 為 null

IllegalArgumentException - 如果 dropAction 不是 DnDConstants 之一。

IllegalArgumentException - 如果 srcAction 不是 DnDConstants 的位遮罩碼。

IllegalArgumentException - 如果 dtc 為 null。

方法詳細資訊

getLocation

public Point getLocation()

此方法返回一個 Point，指示 Component 坐標中 Cursor 的當前位置。

返回：

Component 坐標中 Cursor 的當前位置。

getCurrentDataFlavors

public DataFlavor[] getCurrentDataFlavors()

此方法返回當前的 DataFlavor。

返回：

當前的 DataFlavor

getCurrentDataFlavorsAsList

public List<DataFlavor> getCurrentDataFlavorsAsList()

此方法以 java.util.List 形式返回當前可用的 DataFlavor。

返回：

java.util.List 形式的當前可用 DataFlavor

isDataFlavorSupported

public boolean isDataFlavorSupported(DataFlavor df)

此方法返回一個指示指定的 DataFlavor 是否可在源物件中使用的 boolean 值。

參數：

df - 要測試的 DataFlavor

返回：

是否指定的 DataFlavor 是否可在源物件中使用

getSourceActions

public int getSourceActions()

此方法返回源 drop 操作。

返回：

源 drop 操作。

getDropAction

public int getDropAction()

此方法返回使用者 drop 操作。

返回：

使用者 drop 操作。

getTransferable

public Transferable getTransferable()

此方法返回與 drop 相關的 Transferable 物件。

返回：

與 drop 相關的 Transferable

acceptDrop

public void acceptDrop(int dropAction)

使用指定的操作接受 drop。

參數：

dropAction - 指定的操作

rejectDrop

public void rejectDrop()

拒絕 Drop。

dropComplete

public void dropComplete(boolean success)

此方法通知 DragSource drop 傳輸已完成。

參數：

success - 指示 drop 傳輸已完成的 boolean 值。

isLocalTransfer

public boolean isLocalTransfer()

此方法返回一個指示源對象與目標物件是否在同一 JVM 中的 int。

返回：

Source 是否在同一 JVM 中