java.awt.dnd
介面 DragSourceListener

所有父級介面：

EventListener

所有已知實作類別：

DragSourceAdapter, DragSourceContext

public interface DragSourceListener
extends EventListener

DragSourceListener 定義了事件介面，Drag 和 Drop 操作的始發端使用它來追蹤使用者操作的狀態，並通過 Drag 和 Drop 操作為使用者提供合適的“拖動結束”反饋。

放置點是與上一次 dragEnter() 調用相關聯 的，前提是在此偵聽器上最後一次調用 dragEnter() 滿足以下條件：

• 對應於該放置點，並且
• 隨後沒有在此偵聽器上調用 dragExit()。

從以下版本開始：

1.2

方法摘要

void	dragDropEnd(DragSourceDropEvent dsde) 調用此方法來通知 Drag 和 Drop 操作已完成。
void	dragEnter(DragSourceDragEvent dsde) 鼠標的熱點進入放置點（與平臺相關）時調用該方法。
void	dragExit(DragSourceEvent dse) 鼠標的熱點離開放置點（與平臺相關）時調用該方法。
void	dragOver(DragSourceDragEvent dsde) 鼠標的熱點在放置點（與平臺相關）上移動時調用該方法。
void	dropActionChanged(DragSourceDragEvent dsde) 當使用者修改放置操作時調用該方法。

方法詳細資訊

dragEnter

void dragEnter(DragSourceDragEvent dsde)

鼠標的熱點進入放置點（與平臺相關）時調用該方法。滿足以下所有條件時調用此方法：

• 鼠標的熱點進入與平臺相關的放置點的可操作部分。
• 放置點處於啟動狀態。
• 放置點接受該拖動。

參數：

dsde - DragSourceDragEvent

dragOver

void dragOver(DragSourceDragEvent dsde)

鼠標的熱點在放置點（與平臺相關）上移動時調用該方法。滿足以下所有條件時調用此方法：

• 鼠標的熱點已移動，但是仍舊處於和上一次調用 dragEnter() 相關聯的放置點可操作部分內。
• 放置點仍處於啟動狀態。
• 放置點接受該拖動。

參數：

dsde - DragSourceDragEvent

dropActionChanged

void dropActionChanged(DragSourceDragEvent dsde)

當使用者修改放置操作時調用該方法。當使用者使用的輸入設備狀態改變時調用此方法。這種設備通常是與使用者交互的鼠標按鍵或鍵盤修改鍵。

參數：

dsde - DragSourceDragEvent

dragExit

void dragExit(DragSourceEvent dse)

鼠標的熱點離開放置點（與平臺相關）時調用該方法。滿足以下任一條件時調用此方法：

• 鼠標的熱點不再處於和上一次調用 dragEnter() 相關聯的放置點可操作部分內。

或者

• 與上一次調用 dragEnter() 相關聯的放置點不再處於啟動狀態。

或者

• 與上一次調用 dragEnter() 相關聯的放置點拒絕該拖動。

參數：

dse - DragSourceEvent

dragDropEnd

void dragDropEnd(DragSourceDropEvent dsde)

調用此方法來通知 Drag 和 Drop 操作已完成。可以使用 DragSourceDropEvent 的 getDropSuccess() 方法來確定終止狀態。放置點所選擇的操作由 getDropAction() 方法返回，並應用到 Drop 操作中。一旦此方法完成，則當前的 DragSourceContext 和關聯的資源就變為無效。

參數：

dsde - DragSourceDropEvent