UIElement.PointerCanceled Evento

Definizione

Spazio dei nomi:
Microsoft.UI.Xaml
Modifica

Si verifica quando un puntatore che ha effettuato un contatto perde in modo anomalo 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

PointerEventHandler

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 delle impostazioni di risoluzione o monitoraggio
  • Interazioni di input, ad esempio uno stilo che tocca la stessa superficie di un'azione tocco precedente
  • L'utente si disconnette o interruzioni simili che non sono specifiche dell'app
  • Il numero di contatti simultanei ha superato il numero supportato dal dispositivo

Important

PointerCanceled potrebbe essere generato invece di PointerReleased. Non fare affidamento su PointerPressed e PointerReleased gli eventi che si verificano sempre in coppie. Per funzionare correttamente, l'app deve restare in ascolto e gestire tutti gli eventi che rappresentano le possibili conclusioni di un'azione Di stampa e che include PointerCanceled.

Se PointerCanceled viene attivato, vengono rilasciati tutti i puntatori acquisiti da quel puntatore. Per altre informazioni sull'acquisizione del puntatore, vedi CapturePointer.

Quando si gestisce un PointerCanceled evento, prevedere che alcuni dei dati dell'evento normalmente disponibili per un evento puntatore non saranno significativi nell'oggetto PointerRoutedEventArgs ottenuto tramite il gestore. Ad esempio, il Microsoft. UI. Input.PointerPoint.Position del puntatore non è valido perché il puntatore non esiste più.

PointerCanceled è un evento indirizzato. Per altre info sul concetto di evento indirizzato, vedi 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