# `tkinter.dnd` — Suporte para arrastar e soltar

Código-fonte: Lib/tkinter/dnd.py

Nota

Isto é experimental e deverá ser descontinuado quando for substituído pelo 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 Ligações e Eventos). 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).

A seleção de um objeto de destino ocorre da seguinte forma:

1. Pesquisa de cima para baixo da área sob o mouse para o widget alvo

> - O widget alvo deve ter um atributo chamável dnd_accept

> - Se dnd_accept não estiver presente ou retornar `None`, a pesquisa vai para o widget pai

> - Se nenhum widget de destino for encontrado, o objeto alvo é `None`

2. Chamada para <old_target>.dnd_leave(source, event)

3. Chamada para <new_target>.dnd_enter(source, event)

4. Chamada para <target>.dnd_commit(source, event) para notificar que soltou

5. Chamada para <source>.dnd_end(target, event) para sinalizar o fim do arrastar e soltar

class tkinter.dnd.DndHandler(source, event)

  A classe DndHandler trata de eventos de arrastar e soltar que rastreiam eventos Motion e ButtonRelease na raiz do widget de evento.

  cancel(event=None)

    Cancela o processo de arrastar e soltar.

  finish(event, commit=0)

    Executa o fim das funções de arrastar e soltar.

  on_motion(event)

    Inspeciona a área abaixo do mouse para objetos alvos enquanto o arrasto é executado.

  on_release(event)

    Sinaliza o fim do arrasto quando o padrão de liberação for acionado.

tkinter.dnd.dnd_start(source, event)

  Função de fábrica para processo de arrastar e soltar.

Ver também

Ligações e Eventos