UIElement.IsMouseOver UIElement.IsMouseOver UIElement.IsMouseOver UIElement.IsMouseOver Property

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).Gets a value indicating whether the mouse pointer is located over this element (including child elements in the visual tree). Es una propiedad de dependencia.This is a dependency property.

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.true if mouse pointer is over the element or its child elements; otherwise, false. De manera predeterminada, es false.The default is false.

Implementaciones

Ejemplos

El ejemplo siguiente se hace referencia a esta propiedad como el tipo de propiedad de un Trigger, que forma parte de un <Style.Triggers > bloque.The following example references this property as the property type of a Trigger, part of a <Style.Triggers> block. Si el mouse está encima del control, el texto del control se vuelve azul y el cursor se transforme en una mano.If the mouse is over the control, the control text turns blue and the cursor becomes a hand.

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

Comentarios

Normalmente, los controles son compuestos tal que los distintos elementos dentro del control (el árbol visual) informan del estado del mouse para el control contenedor.Typically, controls are composited such that the various elements inside the control (the visual tree) will all report the mouse state for the containing control. Por ejemplo, un ListBox informará de control de estilo IsMouseOver como true si el mouse en cualquier lugar es a través de la geometría, incluidas las ListBoxItem.For example, a ListBox style control will report IsMouseOver as true if the mouse is anywhere over its geometry, including any ListBoxItem.

Aunque no existe un evento "IsMouseOverChanged análogo" análogo, hacen varios eventos similares.Although an analogous "IsMouseOverChanged" event does not exist, several similar events do. Por ejemplo, puede controlar MouseEnter, MouseMove, y IsMouseDirectlyOverChanged.For example, you can handle MouseEnter, MouseMove, and 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.If this element captures the mouse, this property remains true until mouse capture is lost and the mouse pointer leaves the element bounds.

Algunos controles deliberadamente capturan el mouse en determinadas acciones que no parece que implican directamente el mouse.Some controls deliberately capture the mouse on certain actions that do not appear to directly involve the mouse. Esto puede provocar IsMouseOver que se va a true , aunque aparentemente no ha movido el mouse.This can lead to IsMouseOver being true even though the mouse has not apparently moved.

Información sobre propiedades de dependenciaDependency Property Information

Campo de identificadorIdentifier field IsMouseOverProperty
Establecen las propiedades de metadatos en trueMetadata properties set to true NingunaNone

Se aplica a