UIElement.PointerWheelChanged Ereignis

  • Referenz

Definition

Namespace:
Microsoft.UI.Xaml
Bearbeiten

Tritt auf, wenn sich der Deltawert eines Zeigers ändert.

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" .../>

Ereignistyp

PointerEventHandler

Hinweise

Wenn Sie behandeln PointerWheelChanged, sind Sie in der Regel an dem MouseWheelDelta-Eigenschaftswert interessiert:

  1. Rufen Sie GetCurrentPoint über die Für Ihren Handler verfügbaren PointerRoutedEventArgs auf. Dadurch wird ein PointerPoint zurückgegeben.
  2. Rufen Sie die Eigenschaften des Zeigers ab. Es enthält ein PointerPointProperties-Objekt .
  3. Rufen Sie den MouseWheelDelta-Eigenschaftswert aus dem PointerPointProperties-Objekt ab. Ein positiver Wert gibt an, dass das Rad nach vorne gedreht (vom Benutzer weg) oder nach rechts gekippt wurde; ein negativer Wert gibt an, dass das Rad nach hinten (zum Benutzer) gedreht oder nach links gekippt wurde.

Wenn das Element, in dem Zeigerereignisse auftreten, einen nicht standardmäßigen ManipulationMode-Wert aufweist, kann die Aktion auch zu verschiedenen Manipulationsereignissen wie ManipulationStarted führen. Darüber hinaus können Mausradeingaben als integriertes Manipulationsverhalten von Steuerelementen behandelt werden, auch wenn kein ManipulationMode Wert festgelegt ist. Beispielsweise können bestimmte Steuerelemente wie GridView und ListView Mausradeingaben verarbeiten, um eine Scroll-/Schwenkaktion zu initiieren.

PointerWheelChanged ist ein Routingereignis. Weitere Informationen zum Konzept für routingfähige Ereignisse finden Sie unter Übersicht über Ereignisse und routingfähige Ereignisse.

Bei Toucheingabeaktionen und interaktionsspezifischen Ereignissen oder Manipulationsereignissen, die aus einer Toucheingabeaktion resultieren, muss ein Element bei Treffertests sichtbar sein, damit es der Ereignisquelle entsprechen und das der Aktion zugeordnete Ereignis auslösen kann. UIElement.Visibility muss sichtbar sein. Andere Eigenschaften abgeleiteter Typen wirken sich ebenfalls auf die Treffertestsicht aus. Weitere Informationen finden Sie unter Übersicht über Ereignisse und Routingereignisse.

PointerWheelChanged unterstützt die Möglichkeit, Ereignishandler an die Route anzufügen, die aufgerufen wird, auch wenn die Ereignisdaten für das Ereignis als Behandelt gekennzeichnet sind. Weitere Informationen finden Sie unter AddHandler.

Bestimmte Windows-Runtime-Steuerelemente verfügen möglicherweise über eine klassenbasierte Behandlung für das PointerWheelChanged Eingabeereignis. Wenn ja, verfügt das Steuerelement wahrscheinlich über eine Überschreibung für die OnPointerWheelChanged-Methode. In der Regel wird das Ereignis vom Klassenhandler behandelt, und das PointerWheelChanged Ereignis wird nicht zur Behandlung von Benutzercodehandlern für dieses Steuerelement ausgelöst. Ein Steuerelement kann dies tun, um die Durchquerung der untergeordneten Elemente mithilfe einer Zeigerradaktion zu unterstützen. Weitere Informationen zur Funktionsweise der klassenbasierten Behandlung für Ereignisse finden Sie unter Übersicht über Ereignisse und Routingereignisse.

Gilt für:

Weitere Informationen