DragEventArgs 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 dados para eventos de arrastar e soltar.
public ref class DragEventArgs sealed : RoutedEventArgs/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class DragEventArgs final : RoutedEventArgs[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class DragEventArgs : RoutedEventArgsPublic NotInheritable Class DragEventArgs
Inherits RoutedEventArgs- Herança
- Atributos
Requisitos do Windows
| Família de dispositivos |
Windows 10 (introduzida na 10.0.10240.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (introduzida na v1.0)
|
Comentários
DragEventArgs é usado como dados de evento para esses eventos:
Esses eventos são eventos roteado. Alterar o valor da propriedade Handled de DragEventArgs de um manipulador de eventos pode influenciar como um evento roteado se comporta. Para obter mais informações sobre o conceito de evento roteado, consulte Visão geral de eventos e eventos roteado.
A classe Control tem manipuladores de eventos pré-conectados que os tipos derivados de Control podem substituir para fornecer tratamento baseado em classe para os eventos de arrastar-soltar, e esses métodos também usam DragEventArgs como um parâmetro. Esses métodos são:
A implementação Windows Runtime de conceitos de arrastar e soltar permite que apenas determinados controles e ações de entrada iniciem uma ação de arrastar-soltar. Não há nenhum método DoDragDrop generalizado que permita que qualquer elemento de interface do usuário inicie uma ação de arrastar-soltar. A origem main de uma ação de arrastar e soltar é quando você arrasta os itens de uma lista, como GridView. Para uma ação de arrastar-soltar de item de lista, o valor De dados em dados de evento pode ser potencialmente modificado dos dados padrão definidos pelo controle sobre o item. Isso é feito manipulando o evento DragItemsStarting e trabalhando com o objeto DataPackage obtido da propriedade DragItemsStartingEventArgs.Data nos dados do evento.
Histórico de versão
| Versão do Windows | Versão do SDK | Valor adicionado |
|---|---|---|
| 1607 | 14393 | AllowedOperations |
Propriedades
| AcceptedOperation |
Obtém ou define um valor que especifica quais operações (nenhuma, movimentação, cópia e/ou link) podem ser aceitas pelo destino do evento de arrastar. |
| AllowedOperations |
Obtém um valor que especifica quais operações (nenhuma, movimentação, cópia e/ou link) são permitidas pela origem do evento de arrastar. |
| Data |
Obtém ou define um objeto de dados (DataPackage) que contém os dados associados ao evento de arrastar correspondente. Esse valor não é útil em todos os casos de evento; especificamente, o evento deve ser tratado por um destino suspenso válido. |
| DataView |
Obtém uma cópia somente leitura do objeto Data . |
| DragUIOverride |
Obtém a representação visual dos dados que estão sendo arrastados. |
| Handled |
Obtém ou define um valor que indica o estado atual de manipulação de eventos para um evento roteado enquanto ele trafega na rota. |
| Modifiers |
Obtém uma enumeração do sinalizador que indica o estado atual das teclas SHIFT, CTRL e ALT, bem como o estado dos botões do mouse. |
| OriginalSource |
Obtém uma referência ao objeto que gerou o evento. Isso geralmente é uma parte de modelo de um controle em vez de um elemento que foi declarado na interface do usuário do aplicativo. (Herdado de RoutedEventArgs) |
Métodos
| GetDeferral() |
Dá suporte a operações assíncronas de arrastar e soltar criando e retornando um objeto DragOperationDeferral . |
| GetPosition(UIElement) |
Retorna um ponto de queda relativo a um UIElement especificado. |