UIElement.IsMouseDirectlyOver Propriedade

Definição

Namespace:

System.Windows

Assembly:

PresentationCore.dll

Obtém um valor que indica se a posição do ponteiro do mouse corresponde aos resultados de teste de clique, que levam em consideração a composição de elementos. É uma propriedade de dependência.

C#

public bool IsMouseDirectlyOver { get; }

Valor da propriedade

Boolean

true se o ponteiro do mouse estiver sobre o mesmo resultado do elemento que um teste de clique; caso contrário, false. O padrão é false.

Implementações

IsMouseDirectlyOver

Comentários

Ao contrário IsMouseOverde , essa propriedade será somente true se o ponteiro do mouse estiver sobre o elemento literal , como é para um teste de clique. Se o ponteiro do mouse estiver, em vez disso, sobre um elemento filho, em particular sobre elementos que fazem parte do modelo e da composição mais profundos de um elemento, essa propriedade será false. A menos que você saiba como um controle é composto (por exemplo, você usa essa propriedade em um modelo de controle personalizado para um controle definido), essa propriedade pode retornar resultados inesperados. Para a maioria dos cenários em que você não está criando controles, use IsMouseOver em vez disso.

Se o mouse for capturado por esse elemento e essa propriedade estiver true no momento da captura, essa propriedade continuará retornando true até que a captura do mouse seja perdida e o ponteiro não esteja acima de seus limites.

Informações da propriedade de dependência

Campo Identificador	IsMouseDirectlyOverProperty
Propriedades de metadados definidas como true	Nenhum

Aplica-se a

Confira também

• MouseEnter
• MouseLeave