Partager via

UIElement.PointerCanceled Événement

  • Référence

Définition

Espace de noms:
Microsoft.UI.Xaml
Modifier

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

PointerEventHandler

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 à PointerPressed et PointerReleased aux événements 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 , et qui inclut PointerCanceled.

Si PointerCanceled se déclenche, les captures de pointeur effectuées par ce pointeur sont libérées. Pour plus d’informations sur la capture de pointeur, consultez CapturePointer.

Lors de la gestion d’un PointerCanceled événement, 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, microsoft.UI.Input.PointerPoint.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 de l’événement sont marquées Handled. Consultez AddHandler.

S’applique à

Voir aussi