summaryrefslogtreecommitdiff
path: root/devdocs/python~3.12/library%2Ftkinter.dnd.html
diff options
context:
space:
mode:
authorCraig Jennings <c@cjennings.net>2025-08-14 22:58:58 -0500
committerCraig Jennings <c@cjennings.net>2025-08-14 22:58:58 -0500
commit82ba818ff456bcd6d56a06226e3f27e98fbb55c3 (patch)
tree158cfc17b2f644a10f063cb546752cfaae12c97f /devdocs/python~3.12/library%2Ftkinter.dnd.html
parent9278ddd4ea1a8b1a4c1edaa8894516e3f48d245b (diff)
downloaddotemacs-82ba818ff456bcd6d56a06226e3f27e98fbb55c3.tar.gz
dotemacs-82ba818ff456bcd6d56a06226e3f27e98fbb55c3.zip
removing all downloaded devdocs files
Diffstat (limited to 'devdocs/python~3.12/library%2Ftkinter.dnd.html')
-rw-r--r--devdocs/python~3.12/library%2Ftkinter.dnd.html26
1 files changed, 0 insertions, 26 deletions
diff --git a/devdocs/python~3.12/library%2Ftkinter.dnd.html b/devdocs/python~3.12/library%2Ftkinter.dnd.html
deleted file mode 100644
index db26161a..00000000
--- a/devdocs/python~3.12/library%2Ftkinter.dnd.html
+++ /dev/null
@@ -1,26 +0,0 @@
- <span id="tkinter-dnd-drag-and-drop-support"></span><h1>tkinter.dnd — Drag and drop support</h1> <p><strong>Source code:</strong> <a class="reference external" href="https://github.com/python/cpython/tree/3.12/Lib/tkinter/dnd.py">Lib/tkinter/dnd.py</a></p> <div class="admonition note"> <p class="admonition-title">Note</p> <p>This is experimental and due to be deprecated when it is replaced with the Tk DND.</p> </div> <p>The <a class="reference internal" href="#module-tkinter.dnd" title="tkinter.dnd: Tkinter drag-and-drop interface (Tk)"><code>tkinter.dnd</code></a> module provides drag-and-drop support for objects within a single application, within the same window or between windows. To enable an object to be dragged, you must create an event binding for it that starts the drag-and-drop process. Typically, you bind a ButtonPress event to a callback function that you write (see <a class="reference internal" href="tkinter#bindings-and-events"><span class="std std-ref">Bindings and Events</span></a>). The function should call <a class="reference internal" href="#tkinter.dnd.dnd_start" title="tkinter.dnd.dnd_start"><code>dnd_start()</code></a>, where ‘source’ is the object to be dragged, and ‘event’ is the event that invoked the call (the argument to your callback function).</p> <p>Selection of a target object occurs as follows:</p> <ol class="arabic simple"> <li>Top-down search of area under mouse for target widget</li> </ol> <ul class="simple"> <li>Target widget should have a callable <em>dnd_accept</em> attribute</li> <li>If <em>dnd_accept</em> is not present or returns None, search moves to parent widget</li> <li>If no target widget is found, then the target object is None</li> </ul> <ol class="arabic simple" start="2"> <li>Call to <em>&lt;old_target&gt;.dnd_leave(source, event)</em>
-</li> <li>Call to <em>&lt;new_target&gt;.dnd_enter(source, event)</em>
-</li> <li>Call to <em>&lt;target&gt;.dnd_commit(source, event)</em> to notify of drop</li> <li>Call to <em>&lt;source&gt;.dnd_end(target, event)</em> to signal end of drag-and-drop</li> </ol> <dl class="py class"> <dt class="sig sig-object py" id="tkinter.dnd.DndHandler">
-<code>class tkinter.dnd.DndHandler(source, event)</code> </dt> <dd>
-<p>The <em>DndHandler</em> class handles drag-and-drop events tracking Motion and ButtonRelease events on the root of the event widget.</p> <dl class="py method"> <dt class="sig sig-object py" id="tkinter.dnd.DndHandler.cancel">
-<code>cancel(event=None)</code> </dt> <dd>
-<p>Cancel the drag-and-drop process.</p> </dd>
-</dl> <dl class="py method"> <dt class="sig sig-object py" id="tkinter.dnd.DndHandler.finish">
-<code>finish(event, commit=0)</code> </dt> <dd>
-<p>Execute end of drag-and-drop functions.</p> </dd>
-</dl> <dl class="py method"> <dt class="sig sig-object py" id="tkinter.dnd.DndHandler.on_motion">
-<code>on_motion(event)</code> </dt> <dd>
-<p>Inspect area below mouse for target objects while drag is performed.</p> </dd>
-</dl> <dl class="py method"> <dt class="sig sig-object py" id="tkinter.dnd.DndHandler.on_release">
-<code>on_release(event)</code> </dt> <dd>
-<p>Signal end of drag when the release pattern is triggered.</p> </dd>
-</dl> </dd>
-</dl> <dl class="py function"> <dt class="sig sig-object py" id="tkinter.dnd.dnd_start">
-<code>tkinter.dnd.dnd_start(source, event)</code> </dt> <dd>
-<p>Factory function for drag-and-drop process.</p> </dd>
-</dl> <div class="admonition seealso"> <p class="admonition-title">See also</p> <p><a class="reference internal" href="tkinter#bindings-and-events"><span class="std std-ref">Bindings and Events</span></a></p> </div> <div class="_attribution">
- <p class="_attribution-p">
- &copy; 2001&ndash;2023 Python Software Foundation<br>Licensed under the PSF License.<br>
- <a href="https://docs.python.org/3.12/library/tkinter.dnd.html" class="_attribution-link">https://docs.python.org/3.12/library/tkinter.dnd.html</a>
- </p>
-</div>