tkinter.dnd --- 拖放支援¶

原始碼：Lib/tkinter/dnd.py

tkinter.dnd 模組為單一應用程式內、同一個視窗內或視窗之間的物件提供拖放支援。要讓一個物件可以被拖動，你必須為它建立一個事件繫結來啟動拖放過程。你通常會將一個 ButtonPress 事件繫結到你所寫的回呼函式（請參閱繫結與事件）。該函式應該呼叫 dnd_start()，其中 source 是要被拖動的物件，而 event 是觸發該次呼叫的事件（也就是你的回呼函式的引數）。

目標物件的選擇過程如下：

1. 由上而下搜尋滑鼠下方的區域以尋找目標元件 (widget)：

   • 目標元件應該要有一個可呼叫的 dnd_accept 屬性 (attribute)；

   • 如果 dnd_accept 不存在或回傳 None，搜尋會移至父元件；

   • 如果找不到目標元件，則目標物件為 None。

2. 呼叫 <old_target>.dnd_leave(source, event)。

3. 呼叫 <new_target>.dnd_enter(source, event)。

4. 呼叫 <target>.dnd_commit(source, event) 以通知放下動作。

5. 呼叫 <source>.dnd_end(target, event) 以表示拖放結束。

class tkinter.dnd.DndHandler(source, event)¶

DndHandler 類別處理拖放事件，它會追蹤事件元件的根上的 Motion 和 ButtonRelease 事件。

cancel(event=None)¶

取消拖放過程。

finish(event, commit=0)¶

執行拖放結束函式。

on_motion(event)¶

在拖動過程中檢查滑鼠下方的區域以尋找目標物件。

on_release(event)¶

當釋放模式被觸發時，發出拖動結束的訊號。

tkinter.dnd.dnd_start(source, event)¶

Factory function for the drag-and-drop process. Return the DndHandler instance managing the drag, or None if a drag could not be started.