Ativar o recurso de arrastar e soltar

Experimente trabalhar com o Compose
O Jetpack Compose é o kit de ferramentas de interface recomendado para Android. Aprenda a usar o recurso de arrastar e soltar no Compose.

O framework de arrastar e soltar do Android permite adicionar recursos interativos de arrastar e soltar ao seu app. Com esse recurso, os usuários podem copiar ou mover textos, imagens, objetos e qualquer conteúdo que possa ser representado por um URI de uma View para outra dentro de um app ou entre apps no modo de várias janelas.

String de texto e imagem sendo arrastadas e soltas em um app. String de texto e imagem sendo arrastadas e soltas entre apps no modo de tela dividida.
Figura 1. Arrastar e soltar em um app.
Figura 2. Arrastar e soltar entre apps.

O framework inclui uma classe de eventos de arrastar, listeners de arrastar e classes e métodos auxiliares. Embora tenha sido projetado principalmente para permitir a transferência de dados, você pode usar o framework para outras ações da interface. Por exemplo, você pode criar um app que mistura cores quando o usuário arrasta um ícone colorido sobre outro ícone. No entanto, o restante do documento descreve o framework de arrastar e soltar no contexto da transferência de dados.

Visão geral

Há alguns elementos envolvidos no processo de arrastar.

  1. Origem de arrastar: a visualização do ponto de partida do processo de arrastar e soltar.

  2. Destino de soltar: uma visualização que pode aceitar os dados de arrastar.

  3. Ação de arrastar: uma ação de arrastar é uma representação dos dados que estão sendo arrastados, visível para os usuários.

  4. Eventos de arrastar: conforme o usuário move a ação de arrastar sobre o layout do app, o sistema envia eventos de arrastar para os listeners de eventos de arrastar e os métodos de callback associados aos objetos View no layout.

Uma operação de arrastar e soltar começa quando o usuário faz um gesto de interface que o app reconhece como um sinal para começar a arrastar dados. Em resposta, o app notifica o sistema sobre a inicialização de uma operação de arrastar e soltar. O sistema chama o app para receber uma ação de arrastar e mostrá-la aos usuários durante o processo de arrastar e soltar.

Conforme o usuário move a ação de arrastar sobre o layout do app, o sistema envia eventos de arrastar para os listeners de eventos de arrastar e os métodos de callback associados aos objetos View no layout. Se o usuário soltar a ação de arrastar sobre um destino de soltar, o sistema vai enviar os dados para ele. A operação de arrastar e soltar termina quando o usuário solta a ação de arrastar, mesmo que ela não esteja sobre um destino de soltar.

Tópicos

Principais conceitos
Entender o processo de arrastar e soltar.
DropHelper para operação de arrastar e soltar simplificada
Saiba como implementar o recurso de arrastar e soltar com o DropHelper.
Implementar o recurso de arrastar e soltar com visualizações
Como alternativa, implemente o recurso de arrastar e soltar com as visualizações do Android, o que permite que os desenvolvedores tenham mais controle sobre os detalhes.
Arrastar e soltar no modo de várias janelas
Ofereça suporte ao recurso de arrastar e soltar no modo de várias janelas, permitindo que objetos sejam movidos entre aplicativos diferentes.

Outros recursos