DragDrop Classe

Définition

Espace de noms:

System.Windows

Assembly:

PresentationCore.dll

Fournit des méthodes d’assistance et des champs pour lancer des opérations de glisser-déplacer, y compris une méthode pour commencer une opération de glisser-déplacer et des installations pour ajouter et supprimer des gestionnaires d’événements liés au glisser-déplacer.

public ref class DragDrop abstract sealed

public static class DragDrop

type DragDrop = class

Public Class DragDrop

Héritage

Object

DragDrop

Remarques

Le glisser-déplacer fait généralement référence à une méthode de transfert de données qui implique l’utilisation d’une souris (ou d’un autre appareil pointant) pour sélectionner un ou plusieurs objets, en faisant glisser ces objets sur une cible de déplacement souhaitée dans l’interface utilisateur et en les supprimant. Une opération glisser-déplacer est analogue à une opération de copie (ou couper) et de collage utilisée pour transférer des données d’un objet ou d’une application vers une autre. Les opérations glisser-déplacer impliquent généralement deux parties : une source de glissement à partir de laquelle les données déplacées proviennent et une cible de déplacement qui reçoit les données supprimées. Les événements et méthodes requis pour les opérations de glisser-déplacer sont définis dans la DragDrop classe. Les événements glisser-déplacer sont des événements joints qui peuvent être attachés à n’importe quel UIElement ou ContentElement. La cible de glisser-déplacer peut être des éléments d’interface utilisateur dans la même application ou dans différentes applications. Toutefois, la cible de déplacement doit savoir comment traiter les données transmises par la source de glissement.

Note

Les UIElement classes et ContentElement les classes contiennent des alias pour les événements de glisser-déplacer afin que les événements apparaissent dans la liste des membres de classe lorsque ces classes sont héritées en tant que classe de base. Lorsque vous attachez un gestionnaire d’événements à un événement glisser-déplacer sur l’une de ces classes, le gestionnaire est attaché à l’événement sous-jacent DragDrop et reçoit la même instance de données d’événement. Par exemple, consultez UIElement.Drop.

La source glisser lance une opération de glisser-déplacer en appelant la méthode statique DoDragDrop et en lui transmettant les données transférées. Un élément gère généralement les événements suivants lorsqu’il s’agit d’une source de glissement :

• GiveFeedback

• QueryContinueDrag

Un élément gère généralement les événements suivants lorsqu’il s’agit d’une cible de déplacement :

• DragEnter

• DragLeave

• DragOver

• Drop

Pour plus d’informations et d’exemples, consultez Vue d’ensemble du glisser-déplacer.

Champs

Nom	Description
DragEnterEvent	Identifie l’événement DragEnter attaché.
DragLeaveEvent	Identifie l’événement DragLeave attaché.
DragOverEvent	Identifie l’événement DragOver attaché.
DropEvent	Identifie l’événement Drop attaché.
GiveFeedbackEvent	Identifie l’événement GiveFeedback attaché.
PreviewDragEnterEvent	Identifie l’événement PreviewDragEnter attaché.
PreviewDragLeaveEvent	Identifie l’événement PreviewDragLeave attaché.
PreviewDragOverEvent	Identifie l’événement PreviewDragOver attaché.
PreviewDropEvent	Identifie l’événement PreviewDrop attaché.
PreviewGiveFeedbackEvent	Identifie l’événement PreviewGiveFeedback attaché.
PreviewQueryContinueDragEvent	Identifie l’événement PreviewQueryContinueDrag attaché.
QueryContinueDragEvent	Identifie l’événement QueryContinueDrag attaché.

Méthodes

Nom	Description
AddDragEnterHandler(DependencyObject, DragEventHandler)	Ajoute un gestionnaire d’événements DragEnter à un objet de dépendance spécifié.
AddDragLeaveHandler(DependencyObject, DragEventHandler)	Ajoute un gestionnaire d’événements DragLeave à un objet de dépendance spécifié.
AddDragOverHandler(DependencyObject, DragEventHandler)	Ajoute un gestionnaire d’événements DragOver à un objet de dépendance spécifié.
AddDropHandler(DependencyObject, DragEventHandler)	Ajoute un gestionnaire d’événements Drop à un objet de dépendance spécifié.
AddGiveFeedbackHandler(DependencyObject, GiveFeedbackEventHandler)	Ajoute un gestionnaire d’événements GiveFeedback à un objet de dépendance spécifié.
AddPreviewDragEnterHandler(DependencyObject, DragEventHandler)	Ajoute un gestionnaire d’événements PreviewDragEnter à un objet de dépendance spécifié.
AddPreviewDragLeaveHandler(DependencyObject, DragEventHandler)	Ajoute un gestionnaire d’événements PreviewDragLeave à un objet de dépendance spécifié.
AddPreviewDragOverHandler(DependencyObject, DragEventHandler)	Ajoute un gestionnaire d’événements PreviewDragOver à un objet de dépendance spécifié.
AddPreviewDropHandler(DependencyObject, DragEventHandler)	Ajoute un gestionnaire d’événements PreviewDrop à un objet de dépendance spécifié.
AddPreviewGiveFeedbackHandler(DependencyObject, GiveFeedbackEventHandler)	Ajoute un gestionnaire d’événements PreviewGiveFeedback à un objet de dépendance spécifié.
AddPreviewQueryContinueDragHandler(DependencyObject, QueryContinueDragEventHandler)	Ajoute un gestionnaire d’événements PreviewQueryContinueDrag à un objet de dépendance spécifié.
AddQueryContinueDragHandler(DependencyObject, QueryContinueDragEventHandler)	Ajoute un gestionnaire d’événements QueryContinueDrag à un objet de dépendance spécifié.
DoDragDrop(DependencyObject, Object, DragDropEffects)	Lance une opération de glisser-déplacer.
RemoveDragEnterHandler(DependencyObject, DragEventHandler)	Supprime un gestionnaire d’événements DragEnter d’un objet de dépendance spécifié.
RemoveDragLeaveHandler(DependencyObject, DragEventHandler)	Supprime un gestionnaire d’événements DragLeave d’un objet de dépendance spécifié.
RemoveDragOverHandler(DependencyObject, DragEventHandler)	Supprime un gestionnaire d’événements DragOver d’un objet de dépendance spécifié.
RemoveDropHandler(DependencyObject, DragEventHandler)	Supprime un gestionnaire d’événements Drop d’un objet de dépendance spécifié.
RemoveGiveFeedbackHandler(DependencyObject, GiveFeedbackEventHandler)	Supprime un gestionnaire d’événements GiveFeedback d’un objet de dépendance spécifié.
RemovePreviewDragEnterHandler(DependencyObject, DragEventHandler)	Supprime un gestionnaire d’événements PreviewDragEnter d’un objet de dépendance spécifié.
RemovePreviewDragLeaveHandler(DependencyObject, DragEventHandler)	Supprime un gestionnaire d’événements PreviewDragLeave d’un objet de dépendance spécifié.
RemovePreviewDragOverHandler(DependencyObject, DragEventHandler)	Supprime un gestionnaire d’événements PreviewDragOver d’un objet de dépendance spécifié.
RemovePreviewDropHandler(DependencyObject, DragEventHandler)	Supprime un gestionnaire d’événements PreviewDrop d’un objet de dépendance spécifié.
RemovePreviewGiveFeedbackHandler(DependencyObject, GiveFeedbackEventHandler)	Supprime un gestionnaire d’événements PreviewGiveFeedback d’un objet de dépendance spécifié.
RemovePreviewQueryContinueDragHandler(DependencyObject, QueryContinueDragEventHandler)	Supprime un gestionnaire d’événements PreviewQueryContinueDrag d’un objet de dépendance spécifié.
RemoveQueryContinueDragHandler(DependencyObject, QueryContinueDragEventHandler)	Supprime un gestionnaire d’événements QueryContinueDrag d’un objet de dépendance spécifié.

Événements attachés

Nom	Description
DragEnter	Se produit lorsqu’un objet est déplacé dans les limites d’un élément qui agit comme une cible de déplacement.
DragLeave	Se produit lorsqu’un objet est déplacé hors des limites d’un élément qui agit comme une cible de déplacement sans être supprimé.
DragOver	Se produit en continu pendant qu’un objet est déplacé dans les limites d’un élément qui agit comme une cible de déplacement.
Drop	Se produit lorsqu’un objet est supprimé dans les limites d’un élément qui agit comme une cible de déplacement.
GiveFeedback	Se produit en continu pendant qu’une opération de glisser-déplacer est en cours et permet à la source de glisser-déplacer d’envoyer des commentaires à l’utilisateur.
PreviewDragEnter	Se produit lorsqu’un objet est déplacé dans les limites d’un élément qui agit comme une cible de déplacement.
PreviewDragLeave	Se produit lorsqu’un objet est déplacé hors des limites d’un élément qui agit comme une cible de déplacement sans être supprimé.
PreviewDragOver	Se produit en continu pendant qu’un objet est déplacé dans les limites d’un élément qui agit comme une cible de déplacement.
PreviewDrop	Se produit lorsqu’un objet est supprimé dans les limites d’un élément qui agit comme une cible de déplacement.
PreviewGiveFeedback	Se produit en continu pendant qu’une opération de glisser-déplacer est en cours et permet à la source de glisser-déplacer d’envoyer des commentaires à l’utilisateur.
PreviewQueryContinueDrag	Se produit en continu pendant qu’une opération de glisser-déplacer est en cours et active la source de déplacement pour mettre fin à l’opération de glisser-déplacer en fonction des états de touche/bouton.
QueryContinueDrag	Se produit en continu pendant qu’une opération de glisser-déplacer est en cours et active la source de déplacement pour mettre fin à l’opération de glisser-déplacer en fonction des états de touche/bouton.

Voir aussi

• DataObject