DragDrop Classe
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Fornece métodos e campos auxiliares para iniciar operações do tipo “arrastar e soltar”, incluindo um método para iniciar uma operação desse tipo e recursos para adicionar e remover manipuladores de eventos relacionados a esse tipo de operação.
public ref class DragDrop abstract sealedpublic static class DragDroptype DragDrop = classPublic Class DragDrop- Herança
-
DragDrop
Comentários
O arrastar e soltar geralmente se refere a um método de transferência de dados que envolve o uso de um mouse (ou algum outro dispositivo apontador) para selecionar um ou mais objetos, arrastando esses objetos sobre algum destino de soltar desejado na interface do usuário e soltando-os. Uma operação de arrastar e soltar é análoga a uma operação de cópia (ou recortar)e colar usada para transferir dados de um objeto ou aplicativo para outro. As operações de arrastar e soltar normalmente envolvem duas partes: uma fonte de arrastar da qual os dados arrastados se originam e um destino de soltar que recebe os dados descartados. Os eventos e métodos necessários para operações de arrastar e soltar são definidos na DragDrop classe . Os eventos de arrastar e soltar são eventos anexados que podem ser anexados a qualquer UIElement ou ContentElement. O destino de arrastar e soltar pode ser elementos de interface do usuário no mesmo aplicativo ou em aplicativos diferentes. No entanto, o destino de soltar deve saber como processar os dados que estão sendo passados pela fonte de arrastar.
Observação
As UIElement classes e ContentElement contêm aliases para os eventos de arrastar e soltar para que os eventos apareçam na lista de membros da classe quando essas classes são herdadas como uma classe base. Quando você anexa um manipulador de eventos a um evento de arrastar e soltar em uma dessas classes, o manipulador é anexado ao evento subjacente DragDrop e eles recebem a mesma instância de dados de evento. Por exemplo, veja UIElement.Drop.
A origem de arrastar inicia uma operação de arrastar e soltar chamando o método estático DoDragDrop e passando os dados transferidos para ele. Um elemento normalmente manipula os seguintes eventos quando é uma fonte de arrastar:
Um elemento normalmente manipula os seguintes eventos quando é um destino de soltar:
Para obter mais informações e exemplos, consulte Visão geral de arrastar e soltar.
Campos
| DragEnterEvent |
Identifica o evento DragEnter anexado. |
| DragLeaveEvent |
Identifica o evento DragLeave anexado. |
| DragOverEvent |
Identifica o evento DragOver anexado. |
| DropEvent |
Identifica o evento Drop anexado. |
| GiveFeedbackEvent |
Identifica o evento GiveFeedback anexado. |
| PreviewDragEnterEvent |
Identifica o evento PreviewDragEnter anexado. |
| PreviewDragLeaveEvent |
Identifica o evento PreviewDragLeave anexado. |
| PreviewDragOverEvent |
Identifica o evento PreviewDragOver anexado. |
| PreviewDropEvent |
Identifica o evento PreviewDrop anexado. |
| PreviewGiveFeedbackEvent |
Identifica o evento PreviewGiveFeedback anexado. |
| PreviewQueryContinueDragEvent |
Identifica o evento PreviewQueryContinueDrag anexado. |
| QueryContinueDragEvent |
Identifica o evento QueryContinueDrag anexado. |
Métodos
Eventos Anexados
| DragEnter |
Ocorre quando um objeto é arrastado para dentro dos limites de um elemento que está atuando como uma reprodução automática. |
| DragLeave |
Ocorre quando um objeto é arrastado para fora dos limites de um elemento que está atuando como um destino de soltar sem ter sido solto. |
| DragOver |
Ocorre continuamente enquanto um objeto é arrastado dentro dos limites de um elemento que está atuando como uma reprodução automática. |
| Drop |
Ocorre quando um objeto é solto nos limites de um elemento que está atuando como uma reprodução automática. |
| GiveFeedback |
Ocorrerá continuamente quando uma operação do tipo "arrastar e soltar" estiver em andamento e habilitará a origem arrastada a fornecer comentários ao usuário. |
| PreviewDragEnter |
Ocorre quando um objeto é arrastado para dentro dos limites de um elemento que está atuando como uma reprodução automática. |
| PreviewDragLeave |
Ocorre quando um objeto é arrastado para fora dos limites de um elemento que está atuando como um destino de soltar sem ter sido solto. |
| PreviewDragOver |
Ocorre continuamente enquanto um objeto é arrastado dentro dos limites de um elemento que está atuando como uma reprodução automática. |
| PreviewDrop |
Ocorre quando um objeto é solto nos limites de um elemento que está atuando como uma reprodução automática. |
| PreviewGiveFeedback |
Ocorrerá continuamente quando uma operação do tipo "arrastar e soltar" estiver em andamento e habilitará a origem arrastada a fornecer comentários ao usuário. |
| PreviewQueryContinueDrag |
Ocorre continuamente quando uma operação do tipo “arrastar e soltar” está em andamento e permite que a origem de soltar encerre a operação do tipo “arrastar e soltar” dependendo dos estados do botão/tecla. |
| QueryContinueDrag |
Ocorre continuamente quando uma operação do tipo “arrastar e soltar” está em andamento e permite que a origem de soltar encerre a operação do tipo “arrastar e soltar” dependendo dos estados do botão/tecla. |
