tkinter.dnd — 拖放支援

原始碼: Lib/tkinter/dnd.py

注意

這是實驗性的，當它被 Tk DND 替換時，將會被棄用。

tkinter.dnd 模組為單個應用程式內、同一視窗內或視窗之間的物件提供拖放支援。要啟用物件的拖動，您必須為其建立一個事件繫結，以啟動拖放過程。通常，您會將 ButtonPress 事件繫結到您編寫的回撥函式（請參閱繫結和事件）。該函式應呼叫dnd_start()，其中 ‘source’ 是要拖動的物件，‘event’ 是呼叫該呼叫的事件（回撥函式的引數）。

目標物件的選擇方式如下：

  1. 自上而下搜尋滑鼠下的區域以查詢目標控制元件

  • 目標控制元件應具有可呼叫的 *dnd_accept* 屬性

  • 如果 *dnd_accept* 不存在或返回 None，則搜尋將移至父控制元件

  • 如果未找到目標控制元件，則目標物件為 None

  1. 呼叫 *<old_target>.dnd_leave(source, event)*

  2. 呼叫 *<new_target>.dnd_enter(source, event)*

  3. 呼叫 *<target>.dnd_commit(source, event)* 以通知放置

  4. 呼叫 *<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)

用於拖放過程的工廠函式。

另請參閱

繫結和事件