UIElement.IsMouseOver Propriedade

public:
 property bool IsMouseOver { bool get(); };

public bool IsMouseOver { get; }

member this.IsMouseOver : bool

Public ReadOnly Property IsMouseOver As Boolean

Valor de Propriedade

true se o ponteiro do rato estiver sobre o elemento ou os seus elementos filhos; caso contrário, false. A predefinição é false.

Implementações

Exemplos

O exemplo seguinte refere esta propriedade como o tipo de propriedade de um Trigger, parte de um <bloco Style.Triggers> . Se o rato estiver sobre o controlo, o texto do controlo fica azul e o cursor passa a ser uma mão.

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

Observações

Normalmente, os controlos são compostos de modo que os vários elementos dentro do controlo (a árvore visual) reportem todos o estado do rato para o controlo que contém. Por exemplo, um ListBox controlo de estilo reportará IsMouseOver como true se o rato estivesse em qualquer parte da sua geometria, incluindo qualquer ListBoxItem.

Embora não exista um evento análogo "IsMouseOverChanged", existem vários eventos semelhantes. Por exemplo, podes tratar MouseEnterde , MouseMove, e IsMouseDirectlyOverChanged.

Se este elemento capturar o rato, esta propriedade mantém-se true até a captura do rato ser perdida e o ponteiro do rato sair dos limites do elemento.

Alguns controlos capturam deliberadamente o rato em certas ações que não parecem envolver diretamente o rato. Isto pode levar a IsMouseOver ser true mesmo que o rato aparentemente não se tenha mexido.

Informação de Propriedade de Dependência