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

En el ejemplo siguiente se hace referencia a esta propiedad como el Triggertipo de propiedad de <una parte de un elemento 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á sobre el control, el texto del control se vuelve azul y el cursor se convierte 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 se componen de forma que los distintos elementos dentro del control (el árbol visual) informen 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 control de estilo se IsMouseOver notificará como true si el mouse estuviera en cualquier parte sobre su ListBoxItemgeometría, incluido any.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 análogo "IsMouseOverChanged", se realizan varios eventos similares.Although an analogous "IsMouseOverChanged" event does not exist, several similar events do. Por ejemplo, puede controlar MouseEnter, MouseMovey 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 sale de 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 capturan deliberadamente el mouse en algunas acciones que no parecen incluir directamente el mouse.Some controls deliberately capture the mouse on certain actions that do not appear to directly involve the mouse. Esto puede dar lugar IsMouseOver a true incluso aunque el mouse no se haya despuesto.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
Propiedades de metadatos establecidas entrueMetadata properties set to true NingunaNone

Se aplica a