DragDrop Classe
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Fornece métodos auxiliares e campos para iniciar operações de arrastar e largar, incluindo um método para iniciar uma operação de arrastar e largar, e funcionalidades para adicionar e remover manipuladores de eventos relacionados com arrastar e largar.
public ref class DragDrop abstract sealedpublic static class DragDroptype DragDrop = classPublic Class DragDrop- Herança
-
DragDrop
Observações
Arrastar e largar refere-se frequentemente a um método de transferência de dados que envolve o uso de um rato (ou outro dispositivo apontador) para selecionar um ou mais objetos, arrastando esses objetos sobre um destino desejado na interface de utilizador (UI) e largando-os. Uma operação de arrastar e largar é análoga a uma operação de copiar (ou cortar) e colar usada para transferir dados de um objeto ou aplicação para outro. As operações de arrastar e largar envolvem tipicamente duas partes: uma fonte de arrasto de onde se originam os dados arrastados e um alvo de largada que recebe os dados largados. Os eventos e métodos necessários para operações de arrastar e largar são definidos na DragDrop classe. Os eventos de arrastar e largar são eventos anexados que podem ser associados a qualquer UIElement ou ContentElement. A origem e o alvo de arrastar podem ser elementos de interface na mesma aplicação ou em aplicações diferentes. No entanto, o drop target deve saber como processar os dados passados pela fonte de arrasto.
Note
As UIElement classes e ContentElement contêm pseudónimos para os eventos de arrastar e largar, de modo que os eventos apareçam na lista de membros da classe quando estas classes são herdadas como classe base. Quando associa um gestor de eventos a um evento de arrastar e largar numa destas classes, o handler é associado ao evento subjacente DragDrop e recebe a mesma instância de dados de evento. Por exemplo, veja UIElement.Drop.
A fonte de arrastar inicia uma operação de arrastar e largar, chamando o método estático DoDragDrop e passando os dados transferidos para ele. Um elemento normalmente lida com os seguintes eventos quando é uma fonte de arrasto:
Um elemento normalmente lida com os seguintes eventos quando é um alvo de queda:
Para mais informações e exemplos, consulte Resumo Arrastar e Soltar.
Campos
| Name | 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
Eventos Anexados
| Name | Description |
|---|---|
| DragEnter |
Ocorre quando um objeto é arrastado para dentro dos limites de um elemento que atua como alvo de queda. |
| DragLeave |
Ocorre quando um objeto é arrastado para fora dos limites de um elemento que atua como alvo de queda sem ser largado. |
| DragOver |
Ocorre continuamente enquanto um objeto é arrastado dentro dos limites de um elemento que atua como alvo de queda. |
| Drop |
Ocorre quando um objeto é largado dentro dos limites de um elemento que atua como alvo de queda. |
| GiveFeedback |
Ocorre continuamente enquanto está em curso uma operação de arrastar e largar, permitindo que a fonte de arrastar dê feedback ao utilizador. |
| PreviewDragEnter |
Ocorre quando um objeto é arrastado para dentro dos limites de um elemento que atua como alvo de queda. |
| PreviewDragLeave |
Ocorre quando um objeto é arrastado para fora dos limites de um elemento que atua como alvo de queda sem ser largado. |
| PreviewDragOver |
Ocorre continuamente enquanto um objeto é arrastado dentro dos limites de um elemento que atua como alvo de queda. |
| PreviewDrop |
Ocorre quando um objeto é largado dentro dos limites de um elemento que atua como alvo de queda. |
| PreviewGiveFeedback |
Ocorre continuamente enquanto está em curso uma operação de arrastar e largar, permitindo que a fonte de arrastar dê feedback ao utilizador. |
| PreviewQueryContinueDrag |
Ocorre continuamente enquanto está em curso uma operação de arrastar e largar, e permite que a fonte de largada termine a operação de arrastar e largar, dependendo dos estados das teclas ou botões. |
| QueryContinueDrag |
Ocorre continuamente enquanto está em curso uma operação de arrastar e largar, e permite que a fonte de largada termine a operação de arrastar e largar, dependendo dos estados das teclas ou botões. |
