UIElement.PointerWheelChanged 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 cambia il valore differenziale di una rotellina del puntatore.
public:
virtual event PointerEventHandler ^ PointerWheelChanged;// Register
event_token PointerWheelChanged(PointerEventHandler const& handler) const;
// Revoke with event_token
void PointerWheelChanged(event_token const* cookie) const;
// Revoke with event_revoker
UIElement::PointerWheelChanged_revoker PointerWheelChanged(auto_revoke_t, PointerEventHandler const& handler) const;public event PointerEventHandler PointerWheelChanged;function onPointerWheelChanged(eventArgs) { /* Your code */ }
uIElement.addEventListener("pointerwheelchanged", onPointerWheelChanged);
uIElement.removeEventListener("pointerwheelchanged", onPointerWheelChanged);
- or -
uIElement.onpointerwheelchanged = onPointerWheelChanged;Public Custom Event PointerWheelChanged As PointerEventHandler <uielement PointerWheelChanged = "eventhandler" .../>
Tipo evento
Commenti
Quando si gestisce PointerWheelChanged, in genere si è interessati al valore della proprietà MouseWheelDelta :
- Chiamare GetCurrentPoint dal pointerRoutedEventArgs disponibile per il gestore. Restituisce un pointerPoint.
- Ottiene le proprietà di PointerPoint. Contiene un oggetto PointerPointProperties .
- Ottiene il valore della proprietà MouseWheelDelta dall'oggetto PointerPointProperties . Un valore positivo indica che la ruota è stata ruotata in avanti (lontano dall'utente) o inclinata verso destra; un valore negativo indica che la ruota è stata ruotata all'indietro (verso l'utente) o inclinata verso sinistra.
Se l'elemento in cui si verificano gli eventi del puntatore ha un valore ManipulationMode non predefinito, l'azione potrebbe comportare anche vari eventi di manipolazione, ad esempio ManipulationStarted. Inoltre, l'input della rotellina del mouse può essere gestito come comportamento di manipolazione predefinito dai controlli, anche senza set di valori ManipulationMode . Ad esempio, alcuni controlli come GridView e ListView possono elaborare l'input della rotellina del mouse per avviare un'azione di scorrimento/panoramica.
PointerWheelChanged è 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.
PointerWheelChanged 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.
I controlli di Windows Runtime specifici possono avere una gestione basata su classi per l'evento di input PointerWheelChanged. In tal caso, è probabile che il controllo abbia un override per il metodo OnPointerWheelChanged. In genere l'evento viene contrassegnato come gestito dal gestore della classe e l'evento PointerWheelChanged non viene generato per la gestione da parte di gestori di codice utente su tale controllo. Un controllo può eseguire questa operazione per supportare l'attraversamento dei relativi elementi figlio tramite un'azione della rotellina del puntatore. Per altre info sul funzionamento della gestione basata su classi per gli eventi, vedi Panoramica degli eventi e degli eventi indirizzati.
Comportamento di Windows 8
Per Windows 8, i movimenti del dispositivo track pad gestiti da una parte di controllo ScrollViewer sono stati interpretati come input della rotellina del mouse e quindi generano un evento PointerWheelChanged. A partire da Windows 8.1, ScrollViewer usa una logica di manipolazione sottostante che interpreta i movimenti del riquadro di rilevamento come azioni a cui risponde ScrollViewer e quindi il movimento viene considerato gestito dal controllo e l'evento PointerWheelChanged non viene più generato.
Se esegui la migrazione del codice dell'app da Windows 8 a Windows 8.1 potresti voler tenere conto di questa modifica del comportamento, perché comporta l'esecuzione di PointerWheelChanged in meno casi. Inoltre, il comportamento predefinito di ScrollViewer potrebbe duplicare ciò che il gestore avrebbe fatto.
Le app create per Windows 8 che vengono eseguite in Windows 8.1 continuano a usare il comportamento di Windows 8.