DragEventArgs Classe

Definição

Namespace:
Microsoft.UI.Xaml
Editar

Fornece dados para eventos de arrastar e soltar.

public ref class DragEventArgs sealed : RoutedEventArgs
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.UI.Xaml.WinUIContract, 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(Microsoft.UI.Xaml.WinUIContract), 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
ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Comentários

DragEventArgs é usado como dados de evento para estes eventos:

Esses eventos são eventos roteado. Alterar o valor da propriedade Handled de um manipulador de DragEventArgs eventos pode influenciar como um evento roteado se comporta. Para obter mais informações sobre o conceito de evento roteado, consulte Eventos e visão geral de eventos roteado.

A classe Control tem manipuladores de eventos pré-conectados que os tipos derivados de Controle podem substituir para fornecer tratamento baseado em classe para os eventos de arrastar e soltar, e esses métodos também usam DragEventArgs como parâmetro. Esses métodos são:

A implementação Windows Runtime de conceitos de arrastar-soltar permite que apenas determinados controles e ações de entrada iniciem uma ação de arrastar-soltar. Não há nenhum método generalizado DoDragDrop que permita que qualquer elemento de interface do usuário inicie uma ação de arrastar-soltar. A principal fonte de uma ação de arrastar-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 potencialmente ser 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.

Propriedades

Nome Description
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, mover, copiar 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 do tratamento de eventos para um evento roteado à medida que percorre a rota.
Modifiers

Obtém uma enumeração de 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

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