UIElement.PointerCaptureLost Événement
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 la capture de pointeur précédemment détenue par cet élément se déplace vers un autre élément ou ailleurs.
public:
virtual event PointerEventHandler ^ PointerCaptureLost;// Register
event_token PointerCaptureLost(PointerEventHandler const& handler) const;
// Revoke with event_token
void PointerCaptureLost(event_token const* cookie) const;
// Revoke with event_revoker
UIElement::PointerCaptureLost_revoker PointerCaptureLost(auto_revoke_t, PointerEventHandler const& handler) const;public event PointerEventHandler PointerCaptureLost;function onPointerCaptureLost(eventArgs) { /* Your code */ }
uIElement.addEventListener("pointercapturelost", onPointerCaptureLost);
uIElement.removeEventListener("pointercapturelost", onPointerCaptureLost);
- or -
uIElement.onpointercapturelost = onPointerCaptureLost;Public Custom Event PointerCaptureLost As PointerEventHandler <uiElement PointerCaptureLost="eventhandler"/>
Important
PointerCaptureLost peut se déclencher à la place 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 des conclusions probables de l’action Appuyer , notamment PointerCaptureLost. Un pointeur peut perdre la capture soit en raison d’interactions utilisateur, soit parce que vous avez capturé un autre pointeur par programmation ou que vous avez délibérément libéré la capture de pointeur actuelle.
Aucun événement ne se déclenche lorsqu’un pointeur est correctement capturé. Pour capturer un pointeur, vous appelez la méthode CapturePointer , ce qui est généralement effectué dans le contexte d’un gestionnaire d’événements pour d’autres événements de pointeur. Pour plus d’informations sur la capture d’un pointeur et la raison pour laquelle vous pouvez le faire, consultez Interactions capturePointer ou souris.
PointerCaptureLost 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.
PointerCaptureLost 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.
| Produit | Versions |
|---|---|
| WinRT | Build 10240, Build 10586, Build 14383, Build 15063, Build 16299, Build 17134, Build 17763, Build 18362, Build 19041, Build 20348, Build 22000, Build 22621, Build 26100 |