"tkinter.dnd" --- Drag and drop support
***************************************

**Code source :** Lib/tkinter/dnd.py

======================================================================

Note:

  Ceci est expérimental et devrait être obsolète lorsqu'il sera
  remplacé par le *Tk DND*.

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 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
Bindings and events). The function should call "dnd_start()", where
*source* is the object to be dragged, and *event* is the event that
invoked the call (the argument to your callback function).

La sélection d'un objet cible se produit comme suit :

1. Top-down search of the area under the mouse for a target widget:

   * the target widget should have a callable *dnd_accept* attribute;

   * if *dnd_accept* is not present or returns "None", the search
     moves to the parent widget;

   * if no target widget is found, the target object is "None".

2. Call to "<old_target>.dnd_leave(source, event)".

3. Call to "<new_target>.dnd_enter(source, event)".

4. Call to "<target>.dnd_commit(source, event)" to notify of the drop.

5. Call to "<source>.dnd_end(target, event)" to signal the end of
   drag-and-drop.

class tkinter.dnd.DndHandler(source, event)

   La classe *DndHandler* gère les événements de glisser-déposer qui
   suivent les événements *Motion* et *ButtonRelease* à la racine du
   widget d'événement.

   cancel(event=None)

      Annule le processus de glisser-déposer.

   finish(event, commit=0)

      Exécute les fonctions de fin de glisser-déposer.

   on_motion(event)

      Inspect area below mouse for target objects while a drag is
      performed.

   on_release(event)

      Signale la fin de la traînée lorsque le modèle de relâchement
      est déclenché.

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.

Voir aussi: Bindings and events
