UIElement.IsStylusDirectlyOver Propriedade

Definição

Obtém um valor que indica se a posição da caneta corresponde aos resultados de teste de clique, que levam em consideração a composição dos elementos.Gets a value that indicates whether the stylus position corresponds to hit test results, which take element compositing into account. É uma propriedade de dependência.This is a dependency property.

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

Valor da propriedade

true se o ponteiro da caneta estiver sobre o mesmo resultado do elemento que um teste de clique; caso contrário, false.true if the stylus 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 IsStylusOver, essa propriedade só será true se a caneta estiver sobre o elemento.Unlike IsStylusOver, this property is only true if the stylus is over the element. Se a caneta estiver em vez de um elemento filho ou sobre elementos que fazem parte da composição mais profunda de um elemento (a árvore visual), essa propriedade será false.If the stylus is instead over a child element or over elements that are part of an element's deeper compositing (the visual tree), 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 IsStylusOver em vez disso.For most scenarios where you are not authoring controls, use IsStylusOver instead.

Se esse elemento tiver a captura da caneta e essa propriedade for true no momento da captura, essa propriedade permanecerá true até que a captura da caneta seja perdida e a caneta não esteja sobre seus limites.If this element has stylus capture and this property is true at the time of capture, this property remains true until stylus capture is lost and the stylus is not over its bounds.

A entrada de toque, mouse e caneta existe em uma relação específica.Touch, mouse, and stylus input exist in a particular relationship. Para obter mais informações, consulte visão geral de entrada.For more information, see Input Overview.

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

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

Aplica-se a

Veja também