DragEventArgs Clase

Definición

Proporciona datos para eventos de arrastrar y colocar.

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

Requisitos de Windows

Familia de dispositivos
Windows 10 (se introdujo en la versión 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (se introdujo en la versión v1.0)

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 evento enrutado, consulta Información general sobre eventos y eventos enrutados.

La clase Control tiene controladores de eventos pre-cableados que control tipos derivados 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 DoDragDrop generalizado que permita que cualquier elemento de la 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 elementos 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.

Historial de versiones

Versión de Windows Versión del SDK Valor agregado
1607 14393 AllowedOperations

Propiedades

AcceptedOperation

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

AllowedOperations

Obtiene un valor que especifica qué operaciones (ninguna, movimiento, copia o vínculo) permiten 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 eventos; 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 declarado 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