UIElement.Drop É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 quand le système d’entrée signale un événement de déplacement sous-jacent avec cet élément comme cible de déplacement.
public:
virtual event DragEventHandler ^ Drop;// Register
event_token Drop(DragEventHandler const& handler) const;
// Revoke with event_token
void Drop(event_token const* cookie) const;
// Revoke with event_revoker
UIElement::Drop_revoker Drop(auto_revoke_t, DragEventHandler const& handler) const;public event DragEventHandler Drop;function onDrop(eventArgs) { /* Your code */ }
uIElement.addEventListener("drop", onDrop);
uIElement.removeEventListener("drop", onDrop);
- or -
uIElement.ondrop = onDrop;Public Custom Event Drop As DragEventHandler <uiElement Drop="eventhandler"/>
Type d'événement
Remarques
Pour Drop qu’il se produise et appelle un gestionnaire, la valeur d’AllowDrop sur l’élément UIElement qui est la cible de suppression et également sur la source d’action de glisser-déplacer doit être true.
Un gestionnaire classique case activée la valeur Data des données des données d’événement DragEventArgs.
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, tout UIElement élément de l’application peut potentiellement être une cible de déplacement tant que AllowDrop se trouve true sur cet élément et que tous les éléments que l’action glisser-déplacer transmet peuvent gérer DragEnter, DragLeave ou DragOver.
Drop est un événement routé. Un élément doit avoir AllowDroptrue pour être une source d’événement Drop . Si l’événement est autorisé à buller vers des éléments parents parce qu’il n’est pas pris en charge, il est possible de gérer l’événement sur un élément parent si AllowDrop se trouve true sur l’élément parent. Les éléments intermédiaires de la route qui ne sont pas l’objet gestionnaire ou la cible de suppression n’ont pas besoin d’AllowDrop pour être true. 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.
Drop 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énementDrop. Si c’est le cas, la logique du contrôle a probablement un remplacement pour la méthode OnDrop. En règle générale, l’événement est marqué géré par le gestionnaire de classes, et l’événement Drop 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.