Compartilhar via


DragDrop Classe

Definição

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
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