java.awt.dnd
類別 DragSourceDropEvent

java.lang.Object
  java.util.EventObject
      java.awt.dnd.DragSourceEvent
          java.awt.dnd.DragSourceDropEvent

所有已實作的介面：

Serializable

public class DragSourceDropEvent
extends DragSourceEvent

通過 DragSourceContext，將 DragSourceDropEvent 從 DragSourceContextPeer 傳遞給向 DragSourceContext 及其關聯 DragSource 註冊的 DragSourceListener 的 dragDropEnd 方法。它包含足夠的資訊，允許操作的發起方在操作完成時向最終使用者提供適當的反饋。

從以下版本開始：

1.2

另請參見：

序列化表格

欄位摘要

從類別 java.util.EventObject 繼承的欄位

source

建構子摘要

DragSourceDropEvent(DragSourceContext dsc)
針對沒有引起放置的拖動建構一個 DragSourceDropEvent。

DragSourceDropEvent(DragSourceContext dsc, int action, boolean success)
放置建構一個具有給定 DragSourceContext、放置操作和指示放置是否成功的 boolean 值的 DragSourceDropEvent。

DragSourceDropEvent(DragSourceContext dsc, int action, boolean success, int x, int y)
針對放置建構一個具有給定 DragSourceContext、放置操作、表示放置是否成功的 boolean 值和坐標的 DragSourceDropEvent。

方法摘要

int	getDropAction() 此方法返回一個 int 值，表示放置主題目標執行的操作。
boolean	getDropSuccess() 此方法返回表示放置是否成功的 boolean 值。

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

getDragSourceContext, getLocation, getX, getY

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

getSource, toString

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

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

建構子詳細資訊

DragSourceDropEvent

public DragSourceDropEvent(DragSourceContext dsc,
                           int action,
                           boolean success)

放置建構一個具有給定 DragSourceContext、放置操作和指示放置是否成功的 boolean 值的 DragSourceDropEvent。未指定此 DragSourceDropEvent 的坐標，所以 getLocation 將在此事件中返回 null。

參數 action 應該是表示單個操作的 DnDConstants 之一。對於無效的 action，此建構子不拋出任何異常。

參數：

dsc - 與此 DragSourceDropEvent 關聯的 DragSourceContext

action - 放置操作

success - 指示放置是否成功的 boolean 值

拋出：

IllegalArgumentException - 如果 dsc 為 null。

另請參見：

DragSourceEvent.getLocation()

DragSourceDropEvent

public DragSourceDropEvent(DragSourceContext dsc,
                           int action,
                           boolean success,
                           int x,
                           int y)

針對放置建構一個具有給定 DragSourceContext、放置操作、表示放置是否成功的 boolean 值和坐標的 DragSourceDropEvent。

參數 action 應該是表示單個操作的 DnDConstants 之一。對於無效的 action，此建構子不拋出任何異常。

參數：

dsc - 與此 DragSourceDropEvent 關聯的 DragSourceContext

action - 放置操作

success - 表示放置是否成功的 boolean 值

x - 鼠標位置的水平坐標

y - 鼠標位置的垂直坐標

拋出：

IllegalArgumentException - 如果 dsc 為 null。

從以下版本開始：

1.4

DragSourceDropEvent

public DragSourceDropEvent(DragSourceContext dsc)

針對沒有引起放置的拖動建構一個 DragSourceDropEvent。未指定此 DragSourceDropEvent 的坐標，所以 getLocation 將為此事件返回 null。

參數：

dsc - DragSourceContext

拋出：

IllegalArgumentException - 如果 dsc 為 null。

另請參見：

DragSourceEvent.getLocation()

方法詳細資訊

getDropSuccess

public boolean getDropSuccess()

此方法返回表示放置是否成功的 boolean 值。

返回：

如果放置目標接受了該放置並且成功地執行了放置操作，則返回 true；如果放置目標拒絕該放置或者放置目標接受了該放置，但是無法執行放置操作，則返回 false。

getDropAction

public int getDropAction()

此方法返回一個 int 值，表示放置主題目標執行的操作。

返回：

如果放置目標接受了該放置並且拖動源支持目標放置操作，則返回放置主題目標執行的操作；否則返回 DnDConstants.ACTION_NONE。