UIElement.DragEnter Événement
Définition
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.
Se produit lorsque le système d’entrée signale un événement de glissement sous-jacent avec cet élément comme cible.
public:
virtual event DragEventHandler ^ DragEnter;// Register
event_token DragEnter(DragEventHandler const& handler) const;
// Revoke with event_token
void DragEnter(event_token const* cookie) const;
// Revoke with event_revoker
UIElement::DragEnter_revoker DragEnter(auto_revoke_t, DragEventHandler const& handler) const;public event DragEventHandler DragEnter;function onDragEnter(eventArgs) { /* Your code */ }
uIElement.addEventListener("dragenter", onDragEnter);
uIElement.removeEventListener("dragenter", onDragEnter);
- or -
uIElement.ondragenter = onDragEnter;Public Custom Event DragEnter As DragEventHandler <uiElement DragEnter="eventhandler"/>
Type d'événement
Remarques
Pour qu’un événement DragEnter se produise, la valeur de AllowDrop sur l’élément UIElement actuel et sur la source de l’événement doit être true. Sinon, envisagez d’utiliser PointerEntered.
Vous pouvez lancer une action glisser-déplacer sur n’importe quel élément 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 déplacement tant que AllowDrop a la valeur true sur cet élément. Tous les éléments que passe l’action glisser-déplacer peuvent gérer DragEnter, DragLeave ou DragOver.
DragEnter 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 de positionnement, par exemple IsEnabled. Pour plus d’informations, consultez Vue d’ensemble des événements et des événements routés.
DragEnter prend en charge la possibilité d’attacher des gestionnaires d’événements à l’itinéraire qui sera appelé même si les données de l’événement sont marquées Handled. Consultez AddHandler.
Des contrôles Windows Runtime spécifiques peuvent avoir une gestion basée sur des classes pour l’événement DragEnter. Dans ce cas, le contrôle a probablement un remplacement pour la méthode OnDragEnter. En règle générale, l’événement est marqué comme géré par le gestionnaire de classe, et l’événement DragEnter 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 à n’importe quel élément d’interface utilisateur d’initier une action de glisser-déplacer. La main source d’une action glisser-déplacer dans une application est lorsque vous faites glisser les éléments d’une liste telle que GridView.