Baoding-FenShuaJiang
/
Green_GoodERP18_FSJ_Standard
Watch 1
Star 0
Wiki 捐赠
gooderp18绿色标准版
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Tree: 0f75e31513
Branches Tags
${ item.name }
Create branch ${ searchTerm }
from '0f75e31513'
${ noResults }
Green_GoodERP18_FSJ_Standard/python/Doc/html/library/tkinter.dnd.html

382 lines
20KB
Raw Blame History 

  1. <!DOCTYPE html>

  2. 

  3. <html lang="en" data-content_root="../">

  4.   <head>

  5.     <meta charset="utf-8" />

  6.     <meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="viewport" content="width=device-width, initial-scale=1" />

  7. <meta property="og:title" content="tkinter.dnd — Drag and drop support" />

  8. <meta property="og:type" content="website" />

  9. <meta property="og:url" content="https://docs.python.org/3/library/tkinter.dnd.html" />

  10. <meta property="og:site_name" content="Python documentation" />

  11. <meta property="og:description" content="Source code: Lib/tkinter/dnd.py The tkinter.dnd 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 d..." />

  12. <meta property="og:image" content="https://docs.python.org/3/_static/og-image.png" />

  13. <meta property="og:image:alt" content="Python documentation" />

  14. <meta name="description" content="Source code: Lib/tkinter/dnd.py The tkinter.dnd 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 d..." />

  15. <meta property="og:image:width" content="200" />

  16. <meta property="og:image:height" content="200" />

  17. <meta name="theme-color" content="#3776ab" />

  18. 

  19.     <title>tkinter.dnd — Drag and drop support &#8212; Python 3.12.3 documentation</title><meta name="viewport" content="width=device-width, initial-scale=1.0">

  20.     

  21.     <link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=80d5e7a1" />

  22.     <link rel="stylesheet" type="text/css" href="../_static/pydoctheme.css?v=bb723527" />

  23.     <link id="pygments_dark_css" media="(prefers-color-scheme: dark)" rel="stylesheet" type="text/css" href="../_static/pygments_dark.css?v=b20cc3f5" />

  24.     

  25.     <script src="../_static/documentation_options.js?v=2c828074"></script>

  26.     <script src="../_static/doctools.js?v=888ff710"></script>

  27.     <script src="../_static/sphinx_highlight.js?v=dc90522c"></script>

  28.     

  29.     <script src="../_static/sidebar.js"></script>

  30.     

  31.     <link rel="search" type="application/opensearchdescription+xml"

  32.           title="Search within Python 3.12.3 documentation"

  33.           href="../_static/opensearch.xml"/>

  34.     <link rel="author" title="About these documents" href="../about.html" />

  35.     <link rel="index" title="Index" href="../genindex.html" />

  36.     <link rel="search" title="Search" href="../search.html" />

  37.     <link rel="copyright" title="Copyright" href="../copyright.html" />

  38.     <link rel="next" title="tkinter.ttk — Tk themed widgets" href="tkinter.ttk.html" />

  39.     <link rel="prev" title="tkinter.scrolledtext — Scrolled Text Widget" href="tkinter.scrolledtext.html" />

  40.     <link rel="canonical" href="https://docs.python.org/3/library/tkinter.dnd.html" />

  41.     

  42.       

  43.     

  44. 

  45.     

  46.     <style>

  47.       @media only screen {

  48.         table.full-width-table {

  49.             width: 100%;

  50.         }

  51.       }

  52.     </style>

  53. <link rel="stylesheet" href="../_static/pydoctheme_dark.css" media="(prefers-color-scheme: dark)" id="pydoctheme_dark_css">

  54.     <link rel="shortcut icon" type="image/png" href="../_static/py.svg" />

  55.             <script type="text/javascript" src="../_static/copybutton.js"></script>

  56.             <script type="text/javascript" src="../_static/menu.js"></script>

  57.             <script type="text/javascript" src="../_static/search-focus.js"></script>

  58.             <script type="text/javascript" src="../_static/themetoggle.js"></script> 

  59. 

  60.   </head>

  61. <body>

  62. <div class="mobile-nav">

  63.     <input type="checkbox" id="menuToggler" class="toggler__input" aria-controls="navigation"

  64.            aria-pressed="false" aria-expanded="false" role="button" aria-label="Menu" />

  65.     <nav class="nav-content" role="navigation">

  66.         <label for="menuToggler" class="toggler__label">

  67.             <span></span>

  68.         </label>

  69.         <span class="nav-items-wrapper">

  70.             <a href="https://www.python.org/" class="nav-logo">

  71.                 <img src="../_static/py.svg" alt="Python logo"/>

  72.             </a>

  73.             <span class="version_switcher_placeholder"></span>

  74.             <form role="search" class="search" action="../search.html" method="get">

  75.                 <svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" class="search-icon">

  76.                     <path fill-rule="nonzero" fill="currentColor" d="M15.5 14h-.79l-.28-.27a6.5 6.5 0 001.48-5.34c-.47-2.78-2.79-5-5.59-5.34a6.505 6.505 0 00-7.27 7.27c.34 2.8 2.56 5.12 5.34 5.59a6.5 6.5 0 005.34-1.48l.27.28v.79l4.25 4.25c.41.41 1.08.41 1.49 0 .41-.41.41-1.08 0-1.49L15.5 14zm-6 0C7.01 14 5 11.99 5 9.5S7.01 5 9.5 5 14 7.01 14 9.5 11.99 14 9.5 14z"></path>

  77.                 </svg>

  78.                 <input placeholder="Quick search" aria-label="Quick search" type="search" name="q" />

  79.                 <input type="submit" value="Go"/>

  80.             </form>

  81.         </span>

  82.     </nav>

  83.     <div class="menu-wrapper">

  84.         <nav class="menu" role="navigation" aria-label="main navigation">

  85.             <div class="language_switcher_placeholder"></div>

  86.             

  87. <label class="theme-selector-label">

  88.     Theme

  89.     <select class="theme-selector" oninput="activateTheme(this.value)">

  90.         <option value="auto" selected>Auto</option>

  91.         <option value="light">Light</option>

  92.         <option value="dark">Dark</option>

  93.     </select>

  94. </label>

  95.   <div>

  96.     <h4>Previous topic</h4>

  97.     <p class="topless"><a href="tkinter.scrolledtext.html"

  98.                           title="previous chapter"><code class="xref py py-mod docutils literal notranslate"><span class="pre">tkinter.scrolledtext</span></code> — Scrolled Text Widget</a></p>

  99.   </div>

  100.   <div>

  101.     <h4>Next topic</h4>

  102.     <p class="topless"><a href="tkinter.ttk.html"

  103.                           title="next chapter"><code class="xref py py-mod docutils literal notranslate"><span class="pre">tkinter.ttk</span></code> — Tk themed widgets</a></p>

  104.   </div>

  105.   <div role="note" aria-label="source link">

  106.     <h3>This Page</h3>

  107.     <ul class="this-page-menu">

  108.       <li><a href="../bugs.html">Report a Bug</a></li>

  109.       <li>

  110.         <a href="https://github.com/python/cpython/blob/main/Doc/library/tkinter.dnd.rst"

  111.             rel="nofollow">Show Source

  112.         </a>

  113.       </li>

  114.     </ul>

  115.   </div>

  116.         </nav>

  117.     </div>

  118. </div>

  119. 

  120.   

  121.     <div class="related" role="navigation" aria-label="related navigation">

  122.       <h3>Navigation</h3>

  123.       <ul>

  124.         <li class="right" style="margin-right: 10px">

  125.           <a href="../genindex.html" title="General Index"

  126.              accesskey="I">index</a></li>

  127.         <li class="right" >

  128.           <a href="../py-modindex.html" title="Python Module Index"

  129.              >modules</a> |</li>

  130.         <li class="right" >

  131.           <a href="tkinter.ttk.html" title="tkinter.ttk — Tk themed widgets"

  132.              accesskey="N">next</a> |</li>

  133.         <li class="right" >

  134.           <a href="tkinter.scrolledtext.html" title="tkinter.scrolledtext — Scrolled Text Widget"

  135.              accesskey="P">previous</a> |</li>

  136. 

  137.           <li><img src="../_static/py.svg" alt="Python logo" style="vertical-align: middle; margin-top: -1px"/></li>

  138.           <li><a href="https://www.python.org/">Python</a> &#187;</li>

  139.           <li class="switchers">

  140.             <div class="language_switcher_placeholder"></div>

  141.             <div class="version_switcher_placeholder"></div>

  142.           </li>

  143.           <li>

  144.               

  145.           </li>

  146.     <li id="cpython-language-and-version">

  147.       <a href="../index.html">3.12.3 Documentation</a> &#187;

  148.     </li>

  149. 

  150.           <li class="nav-item nav-item-1"><a href="index.html" >The Python Standard Library</a> &#187;</li>

  151.           <li class="nav-item nav-item-2"><a href="tk.html" accesskey="U">Graphical User Interfaces with Tk</a> &#187;</li>

  152.         <li class="nav-item nav-item-this"><a href=""><code class="xref py py-mod docutils literal notranslate"><span class="pre">tkinter.dnd</span></code> — Drag and drop support</a></li>

  153.                 <li class="right">

  154.                     

  155. 

  156.     <div class="inline-search" role="search">

  157.         <form class="inline-search" action="../search.html" method="get">

  158.           <input placeholder="Quick search" aria-label="Quick search" type="search" name="q" id="search-box" />

  159.           <input type="submit" value="Go" />

  160.         </form>

  161.     </div>

  162.                      |

  163.                 </li>

  164.             <li class="right">

  165. <label class="theme-selector-label">

  166.     Theme

  167.     <select class="theme-selector" oninput="activateTheme(this.value)">

  168.         <option value="auto" selected>Auto</option>

  169.         <option value="light">Light</option>

  170.         <option value="dark">Dark</option>

  171.     </select>

  172. </label> |</li>

  173.             

  174.       </ul>

  175.     </div>    

  176. 

  177.     <div class="document">

  178.       <div class="documentwrapper">

  179.         <div class="bodywrapper">

  180.           <div class="body" role="main">

  181.             

  182.   <section id="module-tkinter.dnd">

  183. <span id="tkinter-dnd-drag-and-drop-support"></span><h1><a class="reference internal" href="#module-tkinter.dnd" title="tkinter.dnd: Tkinter drag-and-drop interface (Tk)"><code class="xref py py-mod docutils literal notranslate"><span class="pre">tkinter.dnd</span></code></a> — Drag and drop support<a class="headerlink" href="#module-tkinter.dnd" title="Link to this heading">¶</a></h1>

  184. <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>

  185. <hr class="docutils" />

  186. <div class="admonition note">

  187. <p class="admonition-title">Note</p>

  188. <p>This is experimental and due to be deprecated when it is replaced

  189. with the Tk DND.</p>

  190. </div>

  191. <p>The <a class="reference internal" href="#module-tkinter.dnd" title="tkinter.dnd: Tkinter drag-and-drop interface (Tk)"><code class="xref py py-mod docutils literal notranslate"><span class="pre">tkinter.dnd</span></code></a> module provides drag-and-drop support for objects within

  192. a single application, within the same window or between windows. To enable an

  193. object to be dragged, you must create an event binding for it that starts the

  194. drag-and-drop process. Typically, you bind a ButtonPress event to a callback

  195. function that you write (see <a class="reference internal" href="tkinter.html#bindings-and-events"><span class="std std-ref">Bindings and Events</span></a>). The function should

  196. call <a class="reference internal" href="#tkinter.dnd.dnd_start" title="tkinter.dnd.dnd_start"><code class="xref py py-func docutils literal notranslate"><span class="pre">dnd_start()</span></code></a>, where ‘source’ is the object to be dragged, and ‘event’

  197. is the event that invoked the call (the argument to your callback function).</p>

  198. <p>Selection of a target object occurs as follows:</p>

  199. <ol class="arabic simple">

  200. <li><p>Top-down search of area under mouse for target widget</p></li>

  201. </ol>

  202. <blockquote>

  203. <div><ul class="simple">

  204. <li><p>Target widget should have a callable <em>dnd_accept</em> attribute</p></li>

  205. <li><p>If <em>dnd_accept</em> is not present or returns None, search moves to parent widget</p></li>

  206. <li><p>If no target widget is found, then the target object is None</p></li>

  207. </ul>

  208. </div></blockquote>

  209. <ol class="arabic simple" start="2">

  210. <li><p>Call to <em>&lt;old_target&gt;.dnd_leave(source, event)</em></p></li>

  211. <li><p>Call to <em>&lt;new_target&gt;.dnd_enter(source, event)</em></p></li>

  212. <li><p>Call to <em>&lt;target&gt;.dnd_commit(source, event)</em> to notify of drop</p></li>

  213. <li><p>Call to <em>&lt;source&gt;.dnd_end(target, event)</em> to signal end of drag-and-drop</p></li>

  214. </ol>

  215. <dl class="py class">

  216. <dt class="sig sig-object py" id="tkinter.dnd.DndHandler">

  217. <em class="property"><span class="pre">class</span><span class="w"> </span></em><span class="sig-prename descclassname"><span class="pre">tkinter.dnd.</span></span><span class="sig-name descname"><span class="pre">DndHandler</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">source</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">event</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#tkinter.dnd.DndHandler" title="Link to this definition">¶</a></dt>

  218. <dd><p>The <em>DndHandler</em> class handles drag-and-drop events tracking Motion and

  219. ButtonRelease events on the root of the event widget.</p>

  220. <dl class="py method">

  221. <dt class="sig sig-object py" id="tkinter.dnd.DndHandler.cancel">

  222. <span class="sig-name descname"><span class="pre">cancel</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">event</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">None</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#tkinter.dnd.DndHandler.cancel" title="Link to this definition">¶</a></dt>

  223. <dd><p>Cancel the drag-and-drop process.</p>

  224. </dd></dl>

  225. 

  226. <dl class="py method">

  227. <dt class="sig sig-object py" id="tkinter.dnd.DndHandler.finish">

  228. <span class="sig-name descname"><span class="pre">finish</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">event</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">commit</span></span><span class="o"><span class="pre">=</span></span><span class="default_value"><span class="pre">0</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#tkinter.dnd.DndHandler.finish" title="Link to this definition">¶</a></dt>

  229. <dd><p>Execute end of drag-and-drop functions.</p>

  230. </dd></dl>

  231. 

  232. <dl class="py method">

  233. <dt class="sig sig-object py" id="tkinter.dnd.DndHandler.on_motion">

  234. <span class="sig-name descname"><span class="pre">on_motion</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">event</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#tkinter.dnd.DndHandler.on_motion" title="Link to this definition">¶</a></dt>

  235. <dd><p>Inspect area below mouse for target objects while drag is performed.</p>

  236. </dd></dl>

  237. 

  238. <dl class="py method">

  239. <dt class="sig sig-object py" id="tkinter.dnd.DndHandler.on_release">

  240. <span class="sig-name descname"><span class="pre">on_release</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">event</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#tkinter.dnd.DndHandler.on_release" title="Link to this definition">¶</a></dt>

  241. <dd><p>Signal end of drag when the release pattern is triggered.</p>

  242. </dd></dl>

  243. 

  244. </dd></dl>

  245. 

  246. <dl class="py function">

  247. <dt class="sig sig-object py" id="tkinter.dnd.dnd_start">

  248. <span class="sig-prename descclassname"><span class="pre">tkinter.dnd.</span></span><span class="sig-name descname"><span class="pre">dnd_start</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="n"><span class="pre">source</span></span></em>, <em class="sig-param"><span class="n"><span class="pre">event</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#tkinter.dnd.dnd_start" title="Link to this definition">¶</a></dt>

  249. <dd><p>Factory function for drag-and-drop process.</p>

  250. </dd></dl>

  251. 

  252. <div class="admonition seealso">

  253. <p class="admonition-title">See also</p>

  254. <p><a class="reference internal" href="tkinter.html#bindings-and-events"><span class="std std-ref">Bindings and Events</span></a></p>

  255. </div>

  256. </section>

  257. 

  258. 

  259.             <div class="clearer"></div>

  260.           </div>

  261.         </div>

  262.       </div>

  263.       <div class="sphinxsidebar" role="navigation" aria-label="main navigation">

  264.         <div class="sphinxsidebarwrapper">

  265.   <div>

  266.     <h4>Previous topic</h4>

  267.     <p class="topless"><a href="tkinter.scrolledtext.html"

  268.                           title="previous chapter"><code class="xref py py-mod docutils literal notranslate"><span class="pre">tkinter.scrolledtext</span></code> — Scrolled Text Widget</a></p>

  269.   </div>

  270.   <div>

  271.     <h4>Next topic</h4>

  272.     <p class="topless"><a href="tkinter.ttk.html"

  273.                           title="next chapter"><code class="xref py py-mod docutils literal notranslate"><span class="pre">tkinter.ttk</span></code> — Tk themed widgets</a></p>

  274.   </div>

  275.   <div role="note" aria-label="source link">

  276.     <h3>This Page</h3>

  277.     <ul class="this-page-menu">

  278.       <li><a href="../bugs.html">Report a Bug</a></li>

  279.       <li>

  280.         <a href="https://github.com/python/cpython/blob/main/Doc/library/tkinter.dnd.rst"

  281.             rel="nofollow">Show Source

  282.         </a>

  283.       </li>

  284.     </ul>

  285.   </div>

  286.         </div>

  287. <div id="sidebarbutton" title="Collapse sidebar">

  288. <span>«</span>

  289. </div>

  290. 

  291.       </div>

  292.       <div class="clearer"></div>

  293.     </div>  

  294.     <div class="related" role="navigation" aria-label="related navigation">

  295.       <h3>Navigation</h3>

  296.       <ul>

  297.         <li class="right" style="margin-right: 10px">

  298.           <a href="../genindex.html" title="General Index"

  299.              >index</a></li>

  300.         <li class="right" >

  301.           <a href="../py-modindex.html" title="Python Module Index"

  302.              >modules</a> |</li>

  303.         <li class="right" >

  304.           <a href="tkinter.ttk.html" title="tkinter.ttk — Tk themed widgets"

  305.              >next</a> |</li>

  306.         <li class="right" >

  307.           <a href="tkinter.scrolledtext.html" title="tkinter.scrolledtext — Scrolled Text Widget"

  308.              >previous</a> |</li>

  309. 

  310.           <li><img src="../_static/py.svg" alt="Python logo" style="vertical-align: middle; margin-top: -1px"/></li>

  311.           <li><a href="https://www.python.org/">Python</a> &#187;</li>

  312.           <li class="switchers">

  313.             <div class="language_switcher_placeholder"></div>

  314.             <div class="version_switcher_placeholder"></div>

  315.           </li>

  316.           <li>

  317.               

  318.           </li>

  319.     <li id="cpython-language-and-version">

  320.       <a href="../index.html">3.12.3 Documentation</a> &#187;

  321.     </li>

  322. 

  323.           <li class="nav-item nav-item-1"><a href="index.html" >The Python Standard Library</a> &#187;</li>

  324.           <li class="nav-item nav-item-2"><a href="tk.html" >Graphical User Interfaces with Tk</a> &#187;</li>

  325.         <li class="nav-item nav-item-this"><a href=""><code class="xref py py-mod docutils literal notranslate"><span class="pre">tkinter.dnd</span></code> — Drag and drop support</a></li>

  326.                 <li class="right">

  327.                     

  328. 

  329.     <div class="inline-search" role="search">

  330.         <form class="inline-search" action="../search.html" method="get">

  331.           <input placeholder="Quick search" aria-label="Quick search" type="search" name="q" id="search-box" />

  332.           <input type="submit" value="Go" />

  333.         </form>

  334.     </div>

  335.                      |

  336.                 </li>

  337.             <li class="right">

  338. <label class="theme-selector-label">

  339.     Theme

  340.     <select class="theme-selector" oninput="activateTheme(this.value)">

  341.         <option value="auto" selected>Auto</option>

  342.         <option value="light">Light</option>

  343.         <option value="dark">Dark</option>

  344.     </select>

  345. </label> |</li>

  346.             

  347.       </ul>

  348.     </div>  

  349.     <div class="footer">

  350.     &copy; 

  351.       <a href="../copyright.html">

  352.     

  353.     Copyright

  354.     

  355.       </a>

  356.      2001-2024, Python Software Foundation.

  357.     <br />

  358.     This page is licensed under the Python Software Foundation License Version 2.

  359.     <br />

  360.     Examples, recipes, and other code in the documentation are additionally licensed under the Zero Clause BSD License.

  361.     <br />

  362.     

  363.       See <a href="/license.html">History and License</a> for more information.<br />

  364.     

  365.     

  366.     <br />

  367. 

  368.     The Python Software Foundation is a non-profit corporation.

  369. <a href="https://www.python.org/psf/donations/">Please donate.</a>

  370. <br />

  371.     <br />

  372.       Last updated on Apr 09, 2024 (13:47 UTC).

  373.     

  374.       <a href="/bugs.html">Found a bug</a>?

  375.     

  376.     <br />

  377. 

  378.     Created using <a href="https://www.sphinx-doc.org/">Sphinx</a> 7.2.6.

  379.     </div>

  380. 

  381.   </body>

  382. </html>
上海开阖软件有限公司 沪ICP备12045867号-1