UIElement.MouseEnter (Evento)

public event MouseEventHandler MouseEnter

<object MouseEnter="MouseEventHandler" .../>

Implementaciones

• Invalide OnMouseEnter para implementar el control de clases para este evento en las clases derivadas.

MouseEnter es un evento enrutado que usa la estrategia de enrutamiento del control directo de eventos. Los eventos enrutados directos no se provocan en una ruta sino que se controlan en el mismo elemento en el que se provocaron. Sin embargo, habilitan otros aspectos del comportamiento del evento enrutado, como los desencadenadores de eventos de los estilos.

Aunque MouseEnter hace un seguimiento cuando el puntero del mouse entra en los límites de un elemento, este evento informa más literalmente de que el valor de la propiedad IsMouseOver ha cambiado de false a true en este elemento.

Este evento crea un alias para el evento adjunto Mouse.MouseEnter de esta clase, para que MouseEnter forme parte de la lista de miembros de clase cuando UIElement se herede como elemento base. Los controladores de eventos adjuntos al evento MouseEnter se conectan al evento adjunto Mouse.MouseEnter subyacente y reciben la misma instancia de datos de evento.

A Button (o cualquier clase derivada de ButtonBase) dispone de control nativo para un evento KeyDown cuando el botón tiene el foco y la tecla presionada es la barra espaciadora. El control nativo provoca el evento Click con el botón como origen y también captura el mouse, aunque parezca que el puntero del mouse no se mueve. Como resultado de la captura del mouse, un evento MouseEnter se provoca también con el botón como origen. En general, si un elemento captura el mouse, se provoca también MouseEnter, así como GotMouseCapture y posiblemente otros eventos específicos del control.

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.

Nota
This example demonstrates how to use events, but the recommended way to achieve this same effect is to use a Trigger in a style. For more information, see Aplicar estilos y plantillas.

The following XAML creates the user interface, which consists of Border around a TextBlock, and attaches the MouseEnter and MouseLeave event handlers to the Border.

<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 MouseLeave 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.

public partial class Window1 : Window
{
    public Window1()
    {
        InitializeComponent();
    }

    // raised when mouse cursor enters the area occupied by the element
    void OnMouseEnterHandler(object sender, MouseEventArgs e)
    {
        border1.Background = Brushes.Red;
    }

    // raised when mouse cursor leaves the area occupied by the element
    void OnMouseLeaveHandler(object sender, MouseEventArgs e)
    {
        border1.Background = Brushes.White;
    }
}

.NET Framework

.NET Framework Client Profile

Windows 7, Windows Vista SP1 o posterior, Windows XP SP3, Windows Server 2008 (no se admite Server Core), Windows Server 2008 R2 (se admite Server Core con SP1 o posterior), Windows Server 2003 SP2

Referencia

Otros recursos