Share via


DragEventArgs Clase

Definición

Proporciona datos para eventos de arrastrar y colocar.

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
Herencia
Object Platform::Object IInspectable RoutedEventArgs DragEventArgs
Atributos

Comentarios

DragEventArgs se usa como datos de eventos para estos eventos:

Estos eventos son eventos enrutados. Cambiar el valor de la propiedad Handled de DragEventArgs desde un controlador de eventos puede influir en el comportamiento de un evento enrutado. Para obtener más información sobre el concepto de eventos enrutados, consulta Información general sobre eventos y eventos enrutados.

La clase Control tiene controladores de eventos previamente cableados que los tipos derivados de Control pueden invalidar para proporcionar control basado en clases para los eventos de arrastrar y colocar, y estos métodos también usan DragEventArgs como parámetro. Estos métodos son:

La Windows Runtime implementación de conceptos de arrastrar y colocar permite que solo determinados controles y acciones de entrada inicien una acción de arrastrar y colocar. No hay ningún método generalizado DoDragDrop que permita que cualquier elemento de interfaz de usuario inicie una acción de arrastrar y colocar. El origen principal de una acción de arrastrar y colocar es cuando se arrastran los elementos de una lista como GridView. En el caso de una acción de arrastrar y colocar de elemento de lista, el valor De datos en los datos de eventos puede modificarse a partir de los datos predeterminados definidos por el control sobre el elemento. Para ello, se controla el evento DragItemsStarting y se trabaja con el objeto DataPackage que se obtiene de la propiedad DragItemsStartingEventArgs.Data en los datos del evento.

Propiedades

AcceptedOperation

Obtiene o establece un valor que especifica qué operaciones (ninguna, movimiento, copia o vínculo) se pueden aceptar mediante el destino del evento de arrastre.

AllowedOperations

Obtiene un valor que especifica qué operaciones (ninguna, movimiento, copia o vínculo) están permitidas por el origen del evento de arrastre.

Data

Obtiene o establece un objeto de datos (DataPackage) que contiene los datos asociados al evento de arrastre correspondiente. Este valor no es útil en todos los casos de evento; específicamente, el evento debe controlarse mediante un destino de colocación válido.

DataView

Obtiene una copia de solo lectura del objeto Data .

DragUIOverride

Obtiene la representación visual de los datos que se arrastran.

Handled

Obtiene o establece un valor que indica el estado actual del control de eventos para un evento enrutado cuando recorre la ruta.

Modifiers

Obtiene una enumeración de marcadores que indica el estado actual de las teclas MAYÚS, CTRL y ALT, así como el estado de los botones del mouse.

OriginalSource

Obtiene una referencia al objeto que generó el evento. Suele ser una parte de plantilla de un control en lugar de un elemento que se declaró en la interfaz de usuario de la aplicación.

(Heredado de RoutedEventArgs)

Métodos

GetDeferral()

Admite operaciones asincrónicas de arrastrar y colocar mediante la creación y devolución de un objeto DragOperationDeferral .

GetPosition(UIElement)

Devuelve un punto de colocación relativo a un UIElement especificado.

Se aplica a

Consulte también