UIElement.PointerWheelChanged Ereignis

  • Referenz

Definition

Namespace:
Windows.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 PointerWheelChanged behandeln, interessieren Sie sich in der Regel für den MouseWheelDelta-Eigenschaftswert :

  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 Bearbeitungsverhalten 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 Verarbeitet 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.

Windows 8-Verhaltensweise

Für Windows 8 wurden Gesten des Trackpad-Geräts, die von einem ScrollViewer-Steuerelementteil eingegeben wurden, als Mausradeingabe interpretiert und so ein PointerWheelChanged-Ereignis ausgelöst. Ab Windows 8.1 verwendet ScrollViewer eine zugrunde liegende Manipulationslogik, die Gesten des Trackpads als Aktionen interpretiert, auf die der ScrollViewer antwortet, sodass die Geste vom Steuerelement behandelt wird und das PointerWheelChanged-Ereignis nicht mehr ausgelöst wird.

Wenn Sie Ihren App-Code von Windows 8 zu Windows 8.1 migrieren, sollten Sie diese Verhaltensänderung berücksichtigen, da dies dazu führt, dass PointerWheelChanged in weniger Fällen ausgelöst wird. Außerdem kann das Verhalten, das jetzt in ScrollViewer integriert ist, duplizieren, was Ihr Handler getan hätte.

Apps, die für Windows 8 kompiliert wurden, aber unter Windows 8.1 ausgeführt werden, weisen weiterhin das Windows 8-Verhalten auf.

Gilt für:

Weitere Informationen