Condividi tramite


UIElement.PointerCanceled Evento

Definizione

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"/>

Tipo evento

Commenti

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 su PointerPressed ed PointerReleased eventi 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, qualsiasi puntatore acquisisce da quel puntatore viene rilasciato. Per altre informazioni sull'acquisizione del puntatore, vedere CapturePointer.

Quando si gestisce un evento, si prevede che alcuni dei dati dell'evento normalmente disponibili per un PointerCanceled evento puntatore non siano significativi nell'oggetto PointerRoutedEventArgs ottenuto tramite il gestore. Ad esempio, Microsoft.UI.Input.PointerPoint.Position del puntatore non è valido 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.

Si applica a

Vedi anche