Compartilhar via


DragEventArgs Classe

Definição

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 : RoutedEventArgs
Public NotInheritable Class DragEventArgs
Inherits RoutedEventArgs
Herança
Object Platform::Object IInspectable RoutedEventArgs DragEventArgs
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.

Aplica-se a

Confira também