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.Gets a value that indicates whether the position of the mouse pointer corresponds to hit test results, which take element compositing into account. É uma propriedade de dependência.This is a dependency property.

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.true if the mouse pointer is over the same element result as a hit test; otherwise, false. O padrão é false.The default is false.

Implementações

Comentários

Ao contrário de IsMouseOver, essa propriedade só será true se o ponteiro do mouse estiver sobre o elemento literal, como é para um teste de clique.Unlike IsMouseOver, this property is only true if the mouse pointer is over the literal element - as it is for a hit test. Se o ponteiro do mouse estiver em vez de um elemento filho, em particular sobre os elementos que fazem parte do modelo mais profundo de um elemento e a composição, essa propriedade será false.If the mouse pointer is instead over a child element, in particular over elements that are part of an element's deeper template and compositing, this property will be 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 que você define), essa propriedade pode retornar resultados inesperados.Unless you know how a control is composited (for example, you use this property in a custom control template for a control that you define), this property might return unexpected results. Para a maioria dos cenários em que você não está criando controles, use IsMouseOver em vez disso.For most scenarios where you are not authoring controls, use IsMouseOver instead.

Se o mouse for capturado por esse elemento e essa propriedade for true no momento da captura, essa propriedade continuará a retornar true até que a captura do mouse seja perdida e o ponteiro não esteja sobre seus limites.If the mouse is captured by this element, and this property is true at time of capture, this property will continue to return true until mouse capture is lost and the pointer is not over its bounds.

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

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

Aplica-se a

Veja também