UIElement.PointerMoved Evento
Definizione
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 si sposta mentre il puntatore rimane all'interno dell'area hit test di questo elemento.
public:
virtual event PointerEventHandler ^ PointerMoved;// Register
event_token PointerMoved(PointerEventHandler const& handler) const;
// Revoke with event_token
void PointerMoved(event_token const* cookie) const;
// Revoke with event_revoker
UIElement::PointerMoved_revoker PointerMoved(auto_revoke_t, PointerEventHandler const& handler) const;public event PointerEventHandler PointerMoved;function onPointerMoved(eventArgs) { /* Your code */ }
uIElement.addEventListener("pointermoved", onPointerMoved);
uIElement.removeEventListener("pointermoved", onPointerMoved);
- or -
uIElement.onpointermoved = onPointerMoved;Public Custom Event PointerMoved As PointerEventHandler <uiElement PointerMoved="eventhandler"/>
Tipo evento
Commenti
Le interazioni tramite tocco, mouse e penna/stilo vengono ricevute, elaborate e gestite come input del puntatore nell'app UWP. Una di queste interazioni può produrre un PointerMoved evento. Per altre info, vedi Gestire l'input del puntatore e la sezione "Puntatore spostato per l'input del mouse e dello stilo" di questo argomento.
In alcuni scenari dell'interfaccia utente, in particolare se l'utente usa un mouse, questo evento verrà generato molto. Tenere presente il profilo delle prestazioni per il codice inserito in questo gestore e prendere in considerazione i modi per usare flag o tolleranze personalizzati che possono limitare il numero di volte in cui la logica deve effettivamente essere eseguita.
Questo evento è 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.
Questo evento supporta anche la possibilità di associare gestori eventi alla route che verrà richiamata anche se i dati dell'evento per l'evento sono contrassegnati come Handled. Vedere AddHandler.
Puntatore Spostato per l'input dello stilo e del mouse
Un dispositivo di input del mouse ha un cursore sullo schermo visibile ogni volta che il mouse si sposta sui limiti di un elemento, anche se non viene premuto alcun pulsante del mouse al momento. Un comportamento simile è disponibile per l'input penna del dispositivo, in cui i dispositivi di input possono rilevare che la penna sta passando il puntatore del mouse sulla superficie del dispositivo di input, ma non toccandola. L'input tramite mouse e penna genererà PointerMoved quindi eventi più spesso rispetto all'input tocco. Per altre info, vedi Interazioni del mouse.
Al contrario, un punto di tocco è rilevabile solo se un dito tocca la superficie. Un punto di tocco genererà PointerMoved solo mentre il punto di tocco rimane in contatto costante con la superficie mentre si muove. Per questi tipi di azioni di tocco che generano PointerMoved è anche probabile che l'azione venga elaborata come manipolazione o come gesto. Per altre info, vedi Gestire l'input del puntatore.
L'input del mouse è associato a un singolo puntatore assegnato quando viene rilevato per la prima volta l'input del mouse e tutte le interazioni avviate dal mouse hanno lo stesso PointerId. 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 attraverso l'evento PointerMoved . È possibile testare lo stato del pulsante del mouse quando si gestisce questo evento, come illustrato in questo esempio:
Alcune applicazioni, ad esempio i giochi, devono tenere traccia dei movimenti relativi del mouse per funzionalità specifiche (ad esempio, un trackball virtuale o la fotocamera di visualizzazione) e non usano il cursore di sistema o le coordinate dello schermo assolute. Per informazioni dettagliate su come nascondere il cursore del mouse e ignorare i dati assoluti del mouse, vedere Spostamento relativo del mouse e CoreWindow.