java.awt.dnd
類別 DragSourceAdapter

java.lang.Object
  java.awt.dnd.DragSourceAdapter

所有已實作的介面：

DragSourceListener, DragSourceMotionListener, EventListener

public abstract class DragSourceAdapter
extends Object
implements DragSourceListener, DragSourceMotionListener

用於接收拖動源事件的抽象適配器類別。此類別中的方法為空。此類別存在的目的只是為了便於創建偵聽器物件。

擴展此類別即可創建 DragSourceEvent 偵聽器並為感興趣的事件覆寫該方法。（如果實作了 DragSourceListener 介面，則必須定義其中的所有方法。此抽象類別為所有方法都定義了 null 方法，所以只需為關心的事件定義方法即可。）

使用擴展的類別創建偵聽器物件，然後向 DragSource 註冊它。當拖動進入、移過或離開放置點時、放置操作改變時和拖動結束時，調用該偵聽器物件中的相關方法，並將 DragSourceEvent 傳遞給該方法。

如果在此適配器類別上最後一次調用 dragEnter() 是相對於該放置點的，並且後面沒有接著在此適配器類別上調用 dragExit()，則該放置點是與上一次 dragEnter() 調用相關聯的。

從以下版本開始：

1.4

另請參見：

DragSourceEvent, DragSourceListener, DragSourceMotionListener

建構子摘要

DragSourceAdapter()

方法摘要

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

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

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

建構子詳細資訊

DragSourceAdapter

public DragSourceAdapter()

方法詳細資訊

dragEnter

public void dragEnter(DragSourceDragEvent dsde)

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

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

指定者：

介面 DragSourceListener 中的 dragEnter

參數：

dsde - DragSourceDragEvent

dragOver

public void dragOver(DragSourceDragEvent dsde)

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

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

指定者：

介面 DragSourceListener 中的 dragOver

參數：

dsde - DragSourceDragEvent

dragMouseMoved

public void dragMouseMoved(DragSourceDragEvent dsde)

在拖動操作期間，只要移動了鼠標就調用該方法。

指定者：

介面 DragSourceMotionListener 中的 dragMouseMoved

參數：

dsde - DragSourceDragEvent

dropActionChanged

public void dropActionChanged(DragSourceDragEvent dsde)

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

指定者：

介面 DragSourceListener 中的 dropActionChanged

參數：

dsde - DragSourceDragEvent

dragExit

public void dragExit(DragSourceEvent dse)

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

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

或者

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

或者

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

指定者：

介面 DragSourceListener 中的 dragExit

參數：

dse - DragSourceEvent

dragDropEnd

public void dragDropEnd(DragSourceDropEvent dsde)

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

指定者：

介面 DragSourceListener 中的 dragDropEnd

參數：

dsde - DragSourceDropEvent