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). É uma propriedade de dependência.

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. O padrão é 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 <bloco Style.Triggers> . Se o mouse estiver sobre o controle, o texto do controle ficará azul e o cursor se tornará uma mão.

<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 modo que os vários elementos dentro do controle (a árvore visual) relatem o estado do mouse para o controle que o contém. Por exemplo, um ListBox controle de estilo relatará IsMouseOver como true se o mouse estivesse em qualquer lugar sobre sua geometria, incluindo qualquer ListBoxItem.

Embora um evento análogo "IsMouseOverChanged" não exista, vários eventos semelhantes existem. Por exemplo, você pode lidar com MouseEnter, MouseMovee IsMouseDirectlyOverChanged.

Se esse elemento capturar o mouse, essa propriedade permanecerá true até que a captura do mouse seja perdida e o ponteiro do mouse deixe os limites do elemento.

Alguns controles capturam deliberadamente o mouse em determinadas ações que não parecem envolver diretamente o mouse. Isso pode levar a IsMouseOver ser true mesmo que o mouse aparentemente não tenha se movido.

Informações da propriedade de dependência

Campo Identificador IsMouseOverProperty
Propriedades de metadados definidas como true Nenhum

Aplica-se a