Partager via


DragEventArgs Classe

Définition

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

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

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 control peuvent remplacer pour fournir une gestion basée sur les classes pour les événements glisser-déplacer, et ces méthodes utilisent DragEventArgs également 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 de lancer une action de glisser-déplacer. Il n’existe aucune méthode généralisée DoDragDrop permettant à 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 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 sur 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.

Propriétés

AcceptedOperation

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

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 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 déplacement valide.

DataView

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

DragUIOverride

Obtient la représentation visuelle des données déplacées.

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’une partie de modèle 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 de glisser-déplacer asynchrones 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