UIElement.DragOver Événement

Définition

Se produit quand le système d’entrée signale un événement de glissement sous-jacent avec pour cible de dépôt potentielle cet élément.

public:
 virtual event DragEventHandler ^ DragOver;
// Register
event_token DragOver(DragEventHandler const& handler) const;

// Revoke with event_token
void DragOver(event_token const* cookie) const;

// Revoke with event_revoker
UIElement::DragOver_revoker DragOver(auto_revoke_t, DragEventHandler const& handler) const;
public event DragEventHandler DragOver;
function onDragOver(eventArgs) { /* Your code */ }
uIElement.addEventListener("dragover", onDragOver);
uIElement.removeEventListener("dragover", onDragOver);
- or -
uIElement.ondragover = onDragOver;
Public Custom Event DragOver As DragEventHandler 
<uiElement DragOver="eventhandler"/>

Type d'événement

Remarques

Pour que DragOver se produise, la valeur d’AllowDrop sur l’uiElement actuel et sur la source d’événement doit être true. Sinon, envisagez d’utiliser PointerMoved.

Vous pouvez lancer une action de glisser-déplacer sur n’importe quel UIElement en appelant la méthode StartDragAsync . Une fois l’action lancée, n’importe quel élément UIElement dans l’application peut potentiellement être une cible de suppression tant qu’AllowDrop est vrai sur cet élément. Tous les éléments que l’action glisser-déplacer transmet peuvent gérer DragEnter, DragLeave ou DragOver.

DragOver est 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.

Pour les actions tactiles, les actions glisser-déplacer, ainsi que pour les événements spécifiques à l’interaction ou de manipulation qui sont des conséquences d’une action tactile, un élément doit être visible pour être la source de l’événement et déclencher l’événement associé à l’action. UIElement.Visibility doit être visible. D’autres propriétés de types dérivés affectent également la visibilité des tests d’accès, par exemple IsEnabled. Pour plus d’informations, consultez Vue d’ensemble des événements et des événements routés.

DragOver prend en charge la possibilité d’attacher des gestionnaires d’événements à l’itinéraire qui sera appelé même si les données d’événement de l’événement sont marquées Handled. Consultez AddHandler.

Des contrôles Windows Runtime spécifiques peuvent avoir une gestion basée sur les classes pour l’événement DragOver. Si c’est le cas, le contrôle a probablement une substitution pour la méthode OnDragOver. En règle générale, l’événement est marqué géré par le gestionnaire de classes, et l’événement DragOver n’est pas déclenché pour la gestion par les gestionnaires de code utilisateur sur ce contrôle. Pour plus d’informations, consultez Vue d’ensemble des événements et des événements routés.

Indépendamment de l’occurrence de l’événement, certains contrôles peuvent utiliser des animations de thème telles que DragItemThemeAnimation pour indiquer visuellement un comportement de glissement à l’utilisateur.

Windows 8/Windows 8.1 Avant Windows 10, l’implémentation Windows Runtime des concepts de glisser-déplacer autorise uniquement certains contrôles et actions d’entrée à lancer une action de glisser-déplacer. Il n’existe aucune méthode StartDragAsync ou 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 dans une application consiste à faire glisser les éléments d’une liste telle que GridView.

S’applique à

Voir aussi