Occurs when the mouse pointer leaves the bounds of this element.
Assembly: PresentationCore (in PresentationCore.dll)
XMLNS for XAML: http://schemas.microsoft.com/winfx/2006/xaml/presentation, http://schemas.microsoft.com/netfx/2007/xaml/presentation
is a routed event that uses the direct event handling routing strategy. Direct routed events are not raised along a route; instead, they are handled in the same element where they are raised. However, they do enable other aspects of routed event behavior, such as event triggers in styles.
Although tracks when the mouse leaves an element, this event more literally reports that the IsMouseOver property value has changed from true to false on this element.
This event creates an alias for the Mouse.MouseLeave attached event for this class, so that is part of the class members list when UIElement is inherited as a base element. Event handlers that are attached to the event are attached to the underlying Mouse.MouseLeave attached event and receive the same event data instance.
This example shows how to change the color of an element as the mouse pointer enters and leaves the area occupied by the element.
This example consists of a Extensible Application Markup Language (XAML) file and a code-behind file. For the complete samples, see Mouse Pointer Sample.
<StackPanel> <Border MouseEnter="OnMouseEnterHandler" MouseLeave="OnMouseLeaveHandler" Name="border1" Margin="10" BorderThickness="1" BorderBrush="Black" VerticalAlignment="Center" Width="300" Height="100"> <Label Margin="10" FontSize="14" HorizontalAlignment="Center">Move Cursor Over Me</Label> </Border> </StackPanel>
The following code behind creates the MouseEnter and event handlers. When the mouse pointer enters the Border, the background of the Border is changed to red. When the mouse pointer leaves the Border, the background of the Border is changed back to white.
Partial Public Class Window1 Inherits Window Public Sub New() InitializeComponent() End Sub ' raised when mouse cursor enters the are occupied by the element Private Sub OnMouseEnterHandler(ByVal sender As Object, ByVal e As MouseEventArgs) border1.Background = Brushes.Red End Sub ' raised when mouse cursor leaves the are occupied by the element Private Sub OnMouseLeaveHandler(ByVal sender As Object, ByVal e As MouseEventArgs) border1.Background = Brushes.White End Sub End Class
Windows 7, Windows Vista, Windows XP SP2, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003
The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.