UIElement.PointerReleased Evento

  • Riferimento

Definizione

Spazio dei nomi:
Microsoft.UI.Xaml
Modifica

Si verifica quando il dispositivo puntatore che ha avviato in precedenza un'azione Press viene rilasciato, mentre all'interno di questo elemento. Si noti che la fine di un'azione Stampa non è garantita l'attivazione di un PointerReleased evento. Altri eventi potrebbero 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 sugli 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 l'hardware specifico gestisce le azioni tocco e Premere azioni
  • 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 l'input in questione è stato rilevato. Quando si fa clic su un pulsante del mouse (sinistro, rotellina o destro), si crea un’associazione secondaria tra il puntatore e il pulsante premuto mediante 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 di questo evento). A causa di questa associazione esclusiva, altri clic su un pulsante del mouse vengono instradati attraverso l’evento PointerMoved. È possibile testare lo stato del pulsante del mouse durante la gestione di 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 tocco e per gli eventi di modifica o specifici dell'interazione che sono la conseguenza di un'azione tocco, un elemento deve essere visibile tramite hit testing per poter essere l'origine dell'evento e attivare l'evento associato all'azione. UIElement.Visibility deve essere Visible. Altre proprietà dei tipi derivati influiscono anche sulla visibilità degli 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.

Specifici controlli Windows Runtime possono avere una gestione basata su classi per l'evento PointerReleased di input. In tal caso, è probabile che il controllo abbia 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 gestori 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