UIElement.IsMouseDirectlyOver Propriedade

Definição

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.

public:
 property bool IsMouseDirectlyOver { bool get(); };
public bool IsMouseDirectlyOver { get; }
member this.IsMouseDirectlyOver : bool
Public ReadOnly Property IsMouseDirectlyOver As Boolean

Valor da propriedade

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

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