Partage via


UIElement.PointerCanceled Événement

Définition

Se produit lorsqu’un pointeur qui a effectué un contact perd anormalement le contact.

public:
 virtual event PointerEventHandler ^ PointerCanceled;
// Register
event_token PointerCanceled(PointerEventHandler const& handler) const;

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

// Revoke with event_revoker
UIElement::PointerCanceled_revoker PointerCanceled(auto_revoke_t, PointerEventHandler const& handler) const;
public event PointerEventHandler PointerCanceled;
function onPointerCanceled(eventArgs) { /* Your code */ }
uIElement.addEventListener("pointercanceled", onPointerCanceled);
uIElement.removeEventListener("pointercanceled", onPointerCanceled);
- or -
uIElement.onpointercanceled = onPointerCanceled;
Public Custom Event PointerCanceled As PointerEventHandler 
<uiElement PointerCanceled="eventhandler"/>

Type d'événement

Remarques

Voici quelques-unes des raisons pour lesquelles vous pouvez obtenir une occurrence PointerCanceled :

  • Actions de l’utilisateur qui modifient la relation de la zone d’affichage, telles que la modification des paramètres de résolution ou de surveillance
  • Interactions d’entrée telles qu’un stylet touchant la même surface qu’une action tactile précédente
  • L’utilisateur se déconnecte ou des interruptions similaires qui ne sont pas spécifiques à l’application
  • Le nombre de contacts simultanés a dépassé le nombre pris en charge par l’appareil

Important

PointerCanceled peut être déclenché au lieu de PointerReleased. Ne vous fiez pas aux événements PointerPressed et PointerReleased qui se produisent toujours par paires. Pour fonctionner correctement, votre application doit écouter et gérer tous les événements qui représentent les conclusions possibles d’une action Press , notamment PointerCanceled.

Si PointerCanceled se déclenche, tous les pointeurs capturés par ce pointeur sont libérés. Pour plus d’informations sur la capture de pointeur, consultez CapturePointer.

Lors de la gestion d’un événement PointerCanceled, prévoyez que certaines données d’événement normalement disponibles pour un événement de pointeur ne seront pas significatives dans l’objet PointerRoutedEventArgs que vous obtenez via votre gestionnaire. Par exemple, la position du pointeur n’est pas valide, car le pointeur n’existe plus.

PointerCanceled 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.

PointerCanceled 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.

S’applique à

Voir aussi