UIElement.IsMouseOver Propiedad
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
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 |