MouseWheelEventArgs.Handled Property
This API supports the .NET Framework infrastructure and is not intended to be used directly from your code.
[ This article is for Windows Phone 8 developers. If you’re developing for Windows 10, see the latest documentation. ]
Gets or sets a value that marks the routed event as handled, and prevents most handlers along the event route from rehandling the same event.
Namespace: System.Windows.Input
Assembly: System.Windows (in System.Windows.dll)
Syntax
Public Property Handled As Boolean
public bool Handled { get; set; }
Property Value
Type: System..::.Boolean
true if the routed event is marked as handled. false if the routed event is kept unhandled, which permits the event to potentially route further and be acted on by other handlers. The default is false.
Remarks
A property named Handled exists on certain routed-event data classes, and setting its value to true influences behavior of the event system. If you set Handled to true, the event is usually not routed to the next object along the event route.
Generally, you set Handled to true as part of an application event handler. You do so because the user action that initiated the event is considered appropriately handled by the other code that is defined in that event handler. You can still choose to respond to the event in the handler without setting Handled to true; however, know that other objects in the event route will then receive the event and invoke their own event handlers after the current event handler is exited.
For exceptional cases, you can register handlers for a routed event that can act even if Handled is set to true in the event data. However, use caution if you use this handler registration technique. The Handled concept is intended as a coding pattern to prevent spurious or repetitive handling of the same event in a complex object tree, and acting on an already-handled event goes against this design. For more information, see AddHandler.
Version Information
Windows Phone OS
Supported in: 8.1, 8.0, 7.1, 7.0
Platforms
Windows Phone