UIElement.PointerCanceled Evento
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Si verifica quando un puntatore che ha fatto contatto anormale perde il contatto.
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"/>
Alcuni dei motivi per cui si potrebbe ottenere un'occorrenza pointerCanceled sono:
- Azioni utente che modificano la relazione dell'area di visualizzazione, ad esempio la modifica della risoluzione o delle impostazioni di monitoraggio
- Interazioni di input, ad esempio uno stilo che tocca la stessa superficie di un'azione tocco precedente
- L'utente registra interruzioni o interruzioni simili che non sono specifiche dell'app
- Il numero di contatti simultanei ha superato il numero supportato dal dispositivo
Importante
PointerCanceled potrebbe essere attivato anziché PointerReleased. Non basarsi sugli eventi PointerPressed e PointerReleased che si verificano sempre in coppie. Per funzionare correttamente, l'app deve ascoltare e gestire tutti gli eventi che rappresentano le possibili conclusioni di un'azione Press e che include PointerCanceled.
Se PointerCanceled viene generato, vengono rilasciati eventuali acquisizioni del puntatore da tale puntatore. Per altre informazioni sull'acquisizione del puntatore, vedere CapturePointer.
Quando si gestisce un evento PointerCanceled, prevedere che alcuni dei dati dell'evento normalmente disponibili per un evento puntatore non siano significativi nell'oggetto PointerRoutedEventArgs che si ottiene tramite il gestore. Ad esempio, la posizione del puntatore non è valida perché il puntatore non esiste più.
PointerCanceled è un evento instradato. Per altre informazioni sul concetto di evento indirizzato, vedere Panoramica degli eventi e degli eventi indirizzati.
PointerCanceled supporta la possibilità di collegare gestori eventi alla route che verrà richiamata anche se i dati dell'evento per l'evento sono contrassegnati come Handled. Vedere AddHandler.
| Prodotto | Versioni |
|---|---|
| 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 |