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 auxiliares e campos para iniciar operações de arrastar e soltar, incluindo um método para iniciar uma operação de arrastar e soltar e instalações para adicionar e remover manipuladores de eventos relacionados a arrastar e soltar.
public ref class DragDrop abstract sealedpublic static class DragDroptype DragDrop = classPublic Class DragDrop- Herança
-
DragDrop
Comentários
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 apontando) para selecionar um ou mais objetos, arrastando esses objetos sobre algum destino de soltar desejado na interface do usuário (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 que é 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 os 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.
Note
As UIElement classes e ContentElement as classes 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 recebe 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
| Nome | Description |
|---|---|
| DragEnterEvent |
Identifica o DragEnter evento anexado. |
| DragLeaveEvent |
Identifica o DragLeave evento anexado. |
| DragOverEvent |
Identifica o DragOver evento anexado. |
| DropEvent |
Identifica o Drop evento anexado. |
| GiveFeedbackEvent |
Identifica o GiveFeedback evento anexado. |
| PreviewDragEnterEvent |
Identifica o PreviewDragEnter evento anexado. |
| PreviewDragLeaveEvent |
Identifica o PreviewDragLeave evento anexado. |
| PreviewDragOverEvent |
Identifica o PreviewDragOver evento anexado. |
| PreviewDropEvent |
Identifica o PreviewDrop evento anexado. |
| PreviewGiveFeedbackEvent |
Identifica o PreviewGiveFeedback evento anexado. |
| PreviewQueryContinueDragEvent |
Identifica o PreviewQueryContinueDrag evento anexado. |
| QueryContinueDragEvent |
Identifica o QueryContinueDrag evento anexado. |
Métodos
| Nome | Description |
|---|---|
| AddDragEnterHandler(DependencyObject, DragEventHandler) |
Adiciona um DragEnter manipulador de eventos a um objeto de dependência especificado. |
| AddDragLeaveHandler(DependencyObject, DragEventHandler) |
Adiciona um DragLeave manipulador de eventos a um objeto de dependência especificado. |
| AddDragOverHandler(DependencyObject, DragEventHandler) |
Adiciona um DragOver manipulador de eventos a um objeto de dependência especificado. |
| AddDropHandler(DependencyObject, DragEventHandler) |
Adiciona um Drop manipulador de eventos a um objeto de dependência especificado. |
| AddGiveFeedbackHandler(DependencyObject, GiveFeedbackEventHandler) |
Adiciona um GiveFeedback manipulador de eventos a um objeto de dependência especificado. |
| AddPreviewDragEnterHandler(DependencyObject, DragEventHandler) |
Adiciona um PreviewDragEnter manipulador de eventos a um objeto de dependência especificado. |
| AddPreviewDragLeaveHandler(DependencyObject, DragEventHandler) |
Adiciona um PreviewDragLeave manipulador de eventos a um objeto de dependência especificado. |
| AddPreviewDragOverHandler(DependencyObject, DragEventHandler) |
Adiciona um PreviewDragOver manipulador de eventos a um objeto de dependência especificado. |
| AddPreviewDropHandler(DependencyObject, DragEventHandler) |
Adiciona um PreviewDrop manipulador de eventos a um objeto de dependência especificado. |
| AddPreviewGiveFeedbackHandler(DependencyObject, GiveFeedbackEventHandler) |
Adiciona um PreviewGiveFeedback manipulador de eventos a um objeto de dependência especificado. |
| AddPreviewQueryContinueDragHandler(DependencyObject, QueryContinueDragEventHandler) |
Adiciona um PreviewQueryContinueDrag manipulador de eventos a um objeto de dependência especificado. |
| AddQueryContinueDragHandler(DependencyObject, QueryContinueDragEventHandler) |
Adiciona um QueryContinueDrag manipulador de eventos a um objeto de dependência especificado. |
| DoDragDrop(DependencyObject, Object, DragDropEffects) |
Inicia uma operação de arrastar e soltar. |
| RemoveDragEnterHandler(DependencyObject, DragEventHandler) |
Remove um DragEnter manipulador de eventos de um objeto de dependência especificado. |
| RemoveDragLeaveHandler(DependencyObject, DragEventHandler) |
Remove um DragLeave manipulador de eventos de um objeto de dependência especificado. |
| RemoveDragOverHandler(DependencyObject, DragEventHandler) |
Remove um DragOver manipulador de eventos de um objeto de dependência especificado. |
| RemoveDropHandler(DependencyObject, DragEventHandler) |
Remove um Drop manipulador de eventos de um objeto de dependência especificado. |
| RemoveGiveFeedbackHandler(DependencyObject, GiveFeedbackEventHandler) |
Remove um GiveFeedback manipulador de eventos de um objeto de dependência especificado. |
| RemovePreviewDragEnterHandler(DependencyObject, DragEventHandler) |
Remove um PreviewDragEnter manipulador de eventos de um objeto de dependência especificado. |
| RemovePreviewDragLeaveHandler(DependencyObject, DragEventHandler) |
Remove um PreviewDragLeave manipulador de eventos de um objeto de dependência especificado. |
| RemovePreviewDragOverHandler(DependencyObject, DragEventHandler) |
Remove um PreviewDragOver manipulador de eventos de um objeto de dependência especificado. |
| RemovePreviewDropHandler(DependencyObject, DragEventHandler) |
Remove um PreviewDrop manipulador de eventos de um objeto de dependência especificado. |
| RemovePreviewGiveFeedbackHandler(DependencyObject, GiveFeedbackEventHandler) |
Remove um PreviewGiveFeedback manipulador de eventos de um objeto de dependência especificado. |
| RemovePreviewQueryContinueDragHandler(DependencyObject, QueryContinueDragEventHandler) |
Remove um PreviewQueryContinueDrag manipulador de eventos de um objeto de dependência especificado. |
| RemoveQueryContinueDragHandler(DependencyObject, QueryContinueDragEventHandler) |
Remove um QueryContinueDrag manipulador de eventos de um objeto de dependência especificado. |
Eventos Anexados
| Nome | Description |
|---|---|
| DragEnter |
Ocorre quando um objeto é arrastado para os limites de um elemento que está agindo como um destino de soltar. |
| DragLeave |
Ocorre quando um objeto é arrastado para fora dos limites de um elemento que está agindo como um destino de soltar sem ser descartado. |
| DragOver |
Ocorre continuamente enquanto um objeto é arrastado dentro dos limites de um elemento que está agindo como um destino de soltar. |
| Drop |
Ocorre quando um objeto é descartado dentro dos limites de um elemento que está agindo como um destino de soltar. |
| GiveFeedback |
Ocorre continuamente enquanto uma operação de arrastar e soltar está em andamento e permite que a fonte de arrastar envie comentários ao usuário. |
| PreviewDragEnter |
Ocorre quando um objeto é arrastado para os limites de um elemento que está agindo como um destino de soltar. |
| PreviewDragLeave |
Ocorre quando um objeto é arrastado para fora dos limites de um elemento que está agindo como um destino de soltar sem ser descartado. |
| PreviewDragOver |
Ocorre continuamente enquanto um objeto é arrastado dentro dos limites de um elemento que está agindo como um destino de soltar. |
| PreviewDrop |
Ocorre quando um objeto é descartado dentro dos limites de um elemento que está agindo como um destino de soltar. |
| PreviewGiveFeedback |
Ocorre continuamente enquanto uma operação de arrastar e soltar está em andamento e permite que a fonte de arrastar envie comentários ao usuário. |
| PreviewQueryContinueDrag |
Ocorre continuamente enquanto uma operação de arrastar e soltar está em andamento e permite que a origem de soltar encerre a operação de arrastar e soltar, dependendo dos estados de chave/botão. |
| QueryContinueDrag |
Ocorre continuamente enquanto uma operação de arrastar e soltar está em andamento e permite que a origem de soltar encerre a operação de arrastar e soltar, dependendo dos estados de chave/botão. |
