Partager via


DragEventArgs Classe

Définition

Fournit des données pour les événements de glisser-déplacer.

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
Héritage
Object Platform::Object IInspectable RoutedEventArgs DragEventArgs
Attributs

Configuration requise pour Windows

Famille d’appareils
Windows 10 (introduit dans 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduit dans v1.0)

Remarques

DragEventArgs est utilisé comme données d’événement pour ces événements :

Ces événements sont des événements routés. La modification de la valeur de la propriété Handled de DragEventArgs à partir d’un gestionnaire d’événements peut influencer le comportement d’un événement routé. Pour plus d’informations sur le concept d’événement routé, consultez Vue d’ensemble des événements et des événements routés.

La classe Control a des gestionnaires d’événements pré-câblés que les types dérivés de Control peuvent remplacer pour fournir une gestion basée sur les classes pour les événements de glisser-déplacer, et ces méthodes utilisent également DragEventArgs comme paramètre. Ces méthodes sont les suivantes :

L’implémentation Windows Runtime de concepts de glisser-déplacer permet uniquement à certains contrôles et actions d’entrée d’initier une action de glisser-déplacer. Il n’existe aucune méthode DoDragDrop généralisée qui permettrait à un élément d’interface utilisateur de lancer une action de glisser-déplacer. La main source d’une action de glisser-déplacer est lorsque vous faites glisser les éléments d’une liste telle que GridView. Pour une action de glisser-déplacer d’élément de liste, la valeur Data dans les données d’événement peut potentiellement être modifiée à partir des données par défaut définies par le contrôle concernant l’élément. Pour ce faire, gérez l’événement DragItemsStarting et utilisez l’objet DataPackage obtenu à partir de la propriété DragItemsStartingEventArgs.Data dans les données d’événement.

Historique des versions

Version de Windows Version du SDK Valeur ajoutée
1607 14393 AllowedOperations

Propriétés

AcceptedOperation

Obtient ou définit une valeur qui spécifie les opérations (aucune, déplacement, copie et/ou lien) qui peuvent être acceptées par la cible de l’événement glisser.

AllowedOperations

Obtient une valeur qui spécifie les opérations (aucune, déplacement, copie et/ou lien) autorisées par la source de l’événement de glisser.

Data

Obtient ou définit un objet de données (DataPackage) qui contient les données associées à l’événement de glissement correspondant. Cette valeur n’est pas utile dans tous les cas d’événement ; plus précisément, l’événement doit être géré par une cible de suppression valide.

DataView

Obtient une copie en lecture seule de l’objet Data .

DragUIOverride

Obtient la représentation visuelle des données en cours de déplacement.

Handled

Obtient ou définit une valeur qui indique l’état actuel de la gestion des événements pour un événement routé le long de son itinéraire.

Modifiers

Obtient une énumération d'indicateur précisant l'état actuel des touches MAJ, CTRL et ALT, ainsi que l'état des boutons de la souris.

OriginalSource

Obtient une référence à l’objet qui a déclenché l’événement. Il s’agit souvent d’un modèle faisant partie d’un contrôle plutôt que d’un élément qui a été déclaré dans l’interface utilisateur de votre application.

(Hérité de RoutedEventArgs)

Méthodes

GetDeferral()

Prend en charge les opérations asynchrones de glisser-déplacer en créant et en retournant un objet DragOperationDeferral .

GetPosition(UIElement)

Retourne un point de dépôt relatif à un élément UIElement spécifié.

S’applique à

Voir aussi