UIElement.PointerReleased Evento

Definizione

Spazio dei nomi:
Microsoft.UI.Xaml
Modifica

Si verifica quando il dispositivo puntatore che in precedenza ha avviato un'azione Di stampa viene rilasciato, mentre si trova all'interno di questo elemento. Si noti che la fine di un'azione Di stampa non è garantita l'generazione di un PointerReleased evento. In alternativa, altri eventi possono essere attivati. Per altre info, vedi Osservazioni.

public:
 virtual event PointerEventHandler ^ PointerReleased;
// Register
event_token PointerReleased(PointerEventHandler const& handler) const;

// Revoke with event_token
void PointerReleased(event_token const* cookie) const;

// Revoke with event_revoker
UIElement::PointerReleased_revoker PointerReleased(auto_revoke_t, PointerEventHandler const& handler) const;
public event PointerEventHandler PointerReleased;
function onPointerReleased(eventArgs) { /* Your code */ }
uIElement.addEventListener("pointerreleased", onPointerReleased);
uIElement.removeEventListener("pointerreleased", onPointerReleased);
- or -
uIElement.onpointerreleased = onPointerReleased;
Public Custom Event PointerReleased As PointerEventHandler 
<uiElement PointerReleased="eventhandler"/>

Tipo evento

PointerEventHandler

Commenti

Le interazioni tramite tocco, mouse e penna/stilo vengono ricevute, elaborate e gestite come input del puntatore in un'app. Una di queste interazioni può produrre un PointerReleased evento. Per altre info, vedi Gestire l'input del puntatore.

Altri eventi anziché PointerReleased possono essere attivati alla fine dell'azione, ad esempio PointerCanceled o PointerCaptureLost. 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 probabili conclusioni dell'azione Stampa . Alcuni dei motivi per cui si potrebbe non ottenere un'occorrenza PointerReleased sono:

  • Differenze nel modo in cui hardware specifico gestisce le azioni tocco e Press actions
  • Acquisizione di puntatori a livello di codice da un puntatore diverso
  • 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'azione dell'utente che genera inizialmente un PointerReleased evento può comportare l'evento Tapped oppure può comportare anche RightTapped condizioni che variano in base al dispositivo. Per altre info, vedi Tapped e RightTapped.

L'input del mouse è associato a un singolo puntatore assegnato quando viene rilevato per la prima volta l'input del mouse. Facendo clic su un pulsante del mouse (sinistra, rotellina o destra) viene creata un'associazione secondaria tra il puntatore e il pulsante tramite l'evento PointerPressed . L'evento PointerReleased viene generato solo quando lo stesso pulsante del mouse viene rilasciato (nessun altro pulsante può essere associato al puntatore fino al completamento dell'evento). A causa di questa associazione esclusiva, altri clic del pulsante del mouse vengono instradati tramite l'evento PointerMoved . È possibile testare lo stato del pulsante del mouse quando si gestisce questo evento, come illustrato nell'esempio seguente.

PointerReleased è un evento indirizzato. Per altre info sul concetto di evento indirizzato, vedi Panoramica degli eventi e degli eventi indirizzati.

Per le azioni di tocco e anche per gli eventi specifici dell'interazione o di manipolazione che sono conseguenze di un'azione di tocco, un elemento deve essere visibile al test di colpire per poter essere la sorgente dell'evento e generare l'evento associato all'azione. UIElement.Visibility deve essere Visibile. Anche altre proprietà dei tipi derivati influiscono sulla visibilità dei hit test. Per altre informazioni, vedi Panoramica degli eventi e degli eventi indirizzati.

PointerReleased 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.

Controlli Windows Runtime specifici possono avere una gestione basata su classi per l'evento PointerReleased di input. In tal caso, il controllo ha probabilmente un override per il metodo OnPointerReleased. In genere l'evento viene contrassegnato come gestito dal gestore della classe e l'evento non viene generato per la PointerReleased gestione da parte di qualsiasi gestore di codice utente su tale controllo. Per altre info sul funzionamento della gestione basata su classi per gli eventi, vedi Panoramica degli eventi e degli eventi indirizzati.

I controlli possono anche avere un'animazione di personalità PointerUpThemeAnimation che viene eseguita indipendentemente dall'evento.

Si applica a

Vedi anche