接口描述及繼承關係
java.awt.dnd接口DragSourceListener
DragSourceListener 定義了事件接口,Drag 和 Drop 操作的始發端使用它來跟蹤用戶操作的狀態,並通過 Drag 和 Drop 操作為用戶提供合適的“拖動結束”反饋。
放置點是與上一次 dragEnter() 調用相關聯 的,前提是在此偵聽器上最後一次調用 dragEnter() 滿足以下條件:
對應於該放置點,並且
隨後沒有在此偵聽器上調用 dragExit()。
EventListener
所有已知實現類:DragSourceAdapter, DragSourceContextpublic interface DragSourceListenerextends EventListener
從以下版本開始:1.2
方法摘要
void dragDropEnd(DragSourceDropEvent DSDE) 調用此方法來通知 Drag 和 Drop 操作已完成。
void dragEnter(DragSourceDragEvent dsde) 游標的熱點進入放置點(與平台相關)時調用該方法。
void dragExit(DragSourceEvent dse) 游標的熱點離開放置點(與平台相關)時調用該方法。
void dragOver(DragSourceDragEvent dsde) 游標的熱點在放置點(與平台相關)上移動時調用該方法。
void dropActionChanged(DragSourceDragEvent dsde) 當用戶修改放置操作時調用該方法。
方法詳細信息
dragEntervoid dragEnter(DragSourceDragEvent dsde)游標的熱點進入放置點(與平台相關)時調用該方法。滿足以下所有條件時調用此方法:
游標的熱點進入與平台相關的放置點的可操作部分。
放置點處於激活狀態。
放置點接受該拖動。
參數:dsde - DragSourceDragEvent
void dragOver(DragSourceDragEvent dsde)游標的熱點在放置點(與平台相關)上移動時調用該方法。滿足以下所有條件時調用此方法:
游標的熱點已移動,但是仍舊處於和上一次調用 dragEnter() 相關聯的放置點可操作部分內。
放置點仍處於激活狀態。
放置點接受該拖動。
參數:dsde - DragSourceDragEvent
void dropActionChanged(DragSourceDragEvent dsde)當用戶修改放置操作時調用該方法。當用戶使用的輸入設備狀態改變時調用此方法。這種設備通常是與用戶互動的滑鼠按鍵或鍵盤修改鍵。 參數:dsde - DragSourceDragEvent
dragExitvoid dragExit(DragSourceEvent dse)游標的熱點離開放置點(與平台相關)時調用該方法。滿足以下任一條件時調用此方法:
游標的熱點不再處於和上一次調用 dragEnter() 相關聯的放置點可操作部分內。
或者
與上一次調用 dragEnter() 相關聯的放置點不再處於激活狀態。
或者
與上一次調用 dragEnter() 相關聯的放置點拒絕該拖動。
參數:dse - DragSourceEvent
void dragDropEnd(DragSourceDropEvent dsde)調用此方法來通知 Drag 和 Drop 操作已完成。可以使用 DragSourceDropEvent 的 getDropSuccess() 方法來確定終止狀態。放置點所選擇的操作由 getDropAction() 方法返回,並套用到 Drop 操作中。一旦此方法完成,則當前的 DragSourceContext 和關聯的資源就變為無效。 參數:dsde - DragSourceDropEvent