java.awt.dnd
類別 DropTargetDragEvent

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

所有已實作的介面：

Serializable

public class DropTargetDragEvent
extends DropTargetEvent

通過 dragEnter() 和 dragOver() 方法將 DropTargetDragEvent 發送給 DropTargetListener。

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

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

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

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

當使用者選擇一個 drop 操作時，如果此 drop 操作受 drag 源支持，則使用者 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

建構子摘要

DropTargetDragEvent(DropTargetContext dtc, Point cursorLocn, int dropAction, int srcActions)
在給出此操作的 DropTargetContext、Component 坐標中 "Drag" Cursor 熱點的位置、使用者 drop 操作和源 drop 操作的情況下，建構一個 DropTargetDragEvent。

方法摘要

void	acceptDrag(int dragOperation) 接受 drag。
DataFlavor[]	getCurrentDataFlavors() 此方法返回來自 DropTargetContext 的當前 DataFlavor。
List<DataFlavor>	getCurrentDataFlavorsAsList() 此方法以 java.util.List 形式返回當前的 DataFlavor
int	getDropAction() 此方法返回使用者 drop 操作。
Point	getLocation() 此方法返回一個指示 Component 坐標中 Cursor 當前位置的 Point。
int	getSourceActions() 此方法返回源 drop 操作。
Transferable	getTransferable() 此方法返回 Transferable 物件，該物件表示與當前的 drag 操作有關的資料。
boolean	isDataFlavorSupported(DataFlavor df) 此方法返回一個指示指定的 DataFlavor 是否受支持 boolean 值。
void	rejectDrag() 作為檢查 dropAction 或可用的 DataFlavor 型別的結果，拒絕 drag。

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

getDropTargetContext

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

getSource, toString

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

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

建構子詳細資訊

DropTargetDragEvent

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

在給出此操作的 DropTargetContext、Component 坐標中 "Drag" Cursor 熱點的位置、使用者 drop 操作和源 drop 操作的情況下，建構一個 DropTargetDragEvent。

參數：

dtc - 此操作的 DropTargetContext

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

dropAction - 使用者 drop 操作

srcActions - 源 drop 操作

拋出：

NullPointerException - 如果 cursorLocn 為 null

IllegalArgumentException - 如果 dropAction 不是 DnDConstants 之一。

IllegalArgumentException - 如果 srcAction 不是 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()

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

返回：

當前 DataFlavor 的 java.util.List

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()

此方法返回 Transferable 物件，該物件表示與當前的 drag 操作有關的資料。

返回：

與 drag 操作有關的 Transferable

拋出：

InvalidDnDOperationException - 如果與 drag 操作有關的資料不可用

從以下版本開始：

1.5

acceptDrag

public void acceptDrag(int dragOperation)

接受 drag。如果實作希望接受來自 srcAction 的操作，而不是接受使用者選擇的操作（表示為 dropAction），則應該從 DropTargetListener、dragEnter、dragOver 和 dropActionChanged 方法來調用此方法。

參數：

dragOperation - 目標所接受的操作

rejectDrag

public void rejectDrag()

作為檢查 dropAction 或可用的 DataFlavor 型別的結果，拒絕 drag。