DragEventArgs Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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 : RoutedEventArgsPublic NotInheritable Class DragEventArgs
Inherits RoutedEventArgs- Herencia
- 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. |