# `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.

O módulo `tkinter.dnd` fornece suporte de arrastar e soltar para objetos dentro de uma única aplicação, dentro da mesma janela ou entre janelas. Para permitir que um objeto seja arrastado, você deve criar uma associação de evento para ele que inicie o processo de arrastar e soltar. Normalmente, você associa um evento ButtonPress a uma função de retorno que você escreve (consulte Ligações e Eventos). A função deve chamar `dnd_start()`, onde ‘source’ é o objeto a ser arrastado e ‘event’ é o evento que invocou a chamada (o argumento para sua função de retorno).

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