UIElement.IsMouseOver Propriedade

Definição

Obtém um valor que indica se o ponteiro do mouse está localizado sobre esse elemento (incluindo os elementos filho na árvore visual).Gets a value indicating whether the mouse pointer is located over this element (including child elements in the visual tree). É uma propriedade de dependência.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 da propriedade

true se o ponteiro do mouse estiver sobre o elemento ou seus elementos filho; caso contrário, false.true if mouse pointer is over the element or its child elements; otherwise, false. O padrão é false.The default is false.

Implementações

Exemplos

O exemplo a seguir faz referência a essa propriedade como o tipo de propriedade de um Trigger, parte de um estilo de <. dispara > bloco.The following example references this property as the property type of a Trigger, part of a <Style.Triggers> block. Se o mouse estiver sobre o controle, o texto de controle ficará azul e o cursor se tornará uma mão.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>

Comentários

Normalmente, os controles são compostos de forma que os vários elementos dentro do controle (a árvore visual) relatem o estado do mouse para o controle que o contém.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 exemplo, um controle de estilo ListBox relatará IsMouseOver como true se o mouse estiver em qualquer lugar de sua geometria, incluindo qualquer ListBoxItem.For example, a ListBox style control will report IsMouseOver as true if the mouse is anywhere over its geometry, including any ListBoxItem.

Embora um evento análogo "IsMouseOverChanged" não exista, há vários eventos semelhantes.Although an analogous "IsMouseOverChanged" event does not exist, several similar events do. Por exemplo, você pode manipular MouseEnter, MouseMovee IsMouseDirectlyOverChanged.For example, you can handle MouseEnter, MouseMove, and IsMouseDirectlyOverChanged.

Se esse elemento capturar o mouse, essa propriedade permanecerá true até que a captura do mouse seja perdida e o ponteiro do mouse saia dos limites do elemento.If this element captures the mouse, this property remains true until mouse capture is lost and the mouse pointer leaves the element bounds.

Alguns controles deliberadamente capturam o mouse em determinadas ações que não parecem diretamente envolver o mouse.Some controls deliberately capture the mouse on certain actions that do not appear to directly involve the mouse. Isso pode levar a IsMouseOver ser true mesmo que o mouse não tenha sido removido.This can lead to IsMouseOver being true even though the mouse has not apparently moved.

Informações de Propriedade de DependênciaDependency Property Information

Campo de identificadorIdentifier field IsMouseOverProperty
Propriedades de metadados definidas como trueMetadata properties set to true NenhumNone

Aplica-se a