Langage

UIElement.PointerCanceled Événement

Définition

Espace de noms:
Microsoft.UI.Xaml
Modifier

Se produit lorsqu’un pointeur qui a rendu le 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 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 se déclencher au lieu de PointerReleased. Ne vous appuyez pas sur PointerPressed et PointerReleased les événements se produisent toujours en 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 le feu se déclenche, tous les pointeurs capturent par ce pointeur sont libérés. 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, le 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 la vue d’ensemble des événements routés 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. Voir AddHandler.

S’applique à

Voir aussi