UIElement.IsMouseOver Propiedad

Definición

Obtiene un valor que indica si el puntero del mouse se encuentra sobre este elemento (incluidos los elementos secundarios en el árbol visual). Es una propiedad de dependencia.

public:
 property bool IsMouseOver { bool get(); };
public bool IsMouseOver { get; }
member this.IsMouseOver : bool
Public ReadOnly Property IsMouseOver As Boolean

Valor de propiedad

true si el puntero del mouse está sobre el elemento o sus elementos secundarios; en caso contrario, false. De manera predeterminada, es false.

Implementaciones

Ejemplos

En el ejemplo siguiente se hace referencia a esta propiedad como el tipo de propiedad de , Triggerparte de un <bloque Style.Triggers> . Si el mouse está sobre el control, el texto del control se vuelve azul y el cursor se convierte en una mano.

<Trigger Property="IsMouseOver" Value="true">
  <Setter Property="Foreground" Value="Blue" />
  <Setter Property="Cursor" Value="Hand"/>
</Trigger>

Comentarios

Normalmente, los controles se componen de tal forma que los distintos elementos dentro del control (el árbol visual) notificarán el estado del mouse para el control contenedor. Por ejemplo, un ListBox control de estilo notificará IsMouseOver como true si el mouse estuviera en cualquier lugar sobre su geometría, incluido cualquier ListBoxItem.

Aunque no existe un evento "IsMouseOverChanged" análogo, sí existen varios eventos similares. Por ejemplo, puede controlar MouseEnter, MouseMovey IsMouseDirectlyOverChanged.

Si este elemento captura el mouse, esta propiedad permanece true hasta que se pierde la captura del mouse y el puntero del mouse deja los límites del elemento.

Algunos controles capturan deliberadamente el mouse en determinadas acciones que no parecen implicar directamente el mouse. Esto puede dar lugar a IsMouseOver que el true mouse no se haya movido aparentemente.

Información sobre propiedades de dependencia

Campo identificador IsMouseOverProperty
Propiedades de metadatos establecidas en true None

Se aplica a