UIElement.PointerWheelChanged Evento

  • Riferimento

Definizione

Spazio dei nomi:
Microsoft.UI.Xaml
Modifica

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

PointerEventHandler

Commenti

Quando si gestisce PointerWheelChanged, si è in genere interessati al valore della proprietà MouseWheelDelta :

  1. Chiamare GetCurrentPoint dal pointerRoutedEventArgs disponibile per il gestore. Restituisce un pointerPoint.
  2. Ottiene le proprietà di PointerPoint. Contiene un oggetto PointerPointProperties .
  3. 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 alcun ManipulationMode valore impostato. 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.

Specifici controlli Windows Runtime possono avere una gestione basata su classi per l'evento PointerWheelChanged di input. 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 non viene generato per la PointerWheelChanged 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.

Si applica a

Vedi anche