DragDrop Classe

Referência

Definição

Namespace:: System.Windows

Assembly:: PresentationCore.dll

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 sealed

public static class DragDrop

type DragDrop = class

Public Class DragDrop

Herança: Object
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

AddDragEnterHandler(DependencyObject, DragEventHandler)	Adiciona um manipulador de eventos DragEnter a um objeto de dependência especificado.
AddDragLeaveHandler(DependencyObject, DragEventHandler)	Adiciona um manipulador de eventos DragLeave a um objeto de dependência especificado.
AddDragOverHandler(DependencyObject, DragEventHandler)	Adiciona um manipulador de eventos DragOver a um objeto de dependência especificado.
AddDropHandler(DependencyObject, DragEventHandler)	Adiciona um manipulador de eventos Drop a um objeto de dependência especificado.
AddGiveFeedbackHandler(DependencyObject, GiveFeedbackEventHandler)	Adiciona um manipulador de eventos GiveFeedback a um objeto de dependência especificado.
AddPreviewDragEnterHandler(DependencyObject, DragEventHandler)	Adiciona um manipulador de eventos PreviewDragEnter a um objeto de dependência especificado.
AddPreviewDragLeaveHandler(DependencyObject, DragEventHandler)	Adiciona um manipulador de eventos PreviewDragLeave a um objeto de dependência especificado.
AddPreviewDragOverHandler(DependencyObject, DragEventHandler)	Adiciona um manipulador de eventos PreviewDragOver a um objeto de dependência especificado.
AddPreviewDropHandler(DependencyObject, DragEventHandler)	Adiciona um manipulador de eventos PreviewDrop a um objeto de dependência especificado.
AddPreviewGiveFeedbackHandler(DependencyObject, GiveFeedbackEventHandler)	Adiciona um manipulador de eventos PreviewGiveFeedback a um objeto de dependência especificado.
AddPreviewQueryContinueDragHandler(DependencyObject, QueryContinueDragEventHandler)	Adiciona um manipulador de eventos PreviewQueryContinueDrag a um objeto de dependência especificado.
AddQueryContinueDragHandler(DependencyObject, QueryContinueDragEventHandler)	Adiciona um manipulador de eventos QueryContinueDrag a um objeto de dependência especificado.
DoDragDrop(DependencyObject, Object, DragDropEffects)	Inicia uma operação do tipo "arrastar e soltar".
RemoveDragEnterHandler(DependencyObject, DragEventHandler)	Remove um manipulador de eventos DragEnter de um objeto de dependência especificado.
RemoveDragLeaveHandler(DependencyObject, DragEventHandler)	Remove um manipulador de eventos DragLeave de um objeto de dependência especificado.
RemoveDragOverHandler(DependencyObject, DragEventHandler)	Remove um manipulador de eventos DragOver de um objeto de dependência especificado.
RemoveDropHandler(DependencyObject, DragEventHandler)	Remove um manipulador de eventos Drop de um objeto de dependência especificado.
RemoveGiveFeedbackHandler(DependencyObject, GiveFeedbackEventHandler)	Remove um manipulador de eventos GiveFeedback de um objeto de dependência especificado.
RemovePreviewDragEnterHandler(DependencyObject, DragEventHandler)	Remove um manipulador de eventos PreviewDragEnter de um objeto de dependência especificado.
RemovePreviewDragLeaveHandler(DependencyObject, DragEventHandler)	Remove um manipulador de eventos PreviewDragLeave de um objeto de dependência especificado.
RemovePreviewDragOverHandler(DependencyObject, DragEventHandler)	Remove um manipulador de eventos PreviewDragOver de um objeto de dependência especificado.
RemovePreviewDropHandler(DependencyObject, DragEventHandler)	Remove um manipulador de eventos PreviewDrop de um objeto de dependência especificado.
RemovePreviewGiveFeedbackHandler(DependencyObject, GiveFeedbackEventHandler)	Remove um manipulador de eventos PreviewGiveFeedback de um objeto de dependência especificado.
RemovePreviewQueryContinueDragHandler(DependencyObject, QueryContinueDragEventHandler)	Remove um manipulador de eventos PreviewQueryContinueDrag de um objeto de dependência especificado.
RemoveQueryContinueDragHandler(DependencyObject, QueryContinueDragEventHandler)	Remove um manipulador de eventos QueryContinueDrag de um objeto de dependência especificado.

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.

Aplica-se a

Confira também

DataObject

Compartilhar via