DragEventArgs Classe

Référence

Définition

Espace de noms:: Windows.UI.Xaml

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Modifier

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: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

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 à

Partager via