UIElement.IsStylusDirectlyOver Właściwość

Definicja

Pobiera wartość wskazującą, czy pozycja pióra odnosi się do wyników testu trafień, które przyjmują elementy.Gets a value that indicates whether the stylus position corresponds to hit test results, which take element compositing into account. Jest to właściwość zależności.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

Wartość właściwości

Boolean

true Jeśli wskaźnik myszy znajduje się nad tym samym elementem, wynik jako test trafień; w przeciwnym razie false .true if the stylus pointer is over the same element result as a hit test; otherwise, false. Wartość domyślna to false.The default is false.

Implementuje

Uwagi

W przeciwieństwie do IsStylusOver , ta właściwość jest tylko wtedy, true gdy pióro znajduje się nad elementem.Unlike IsStylusOver, this property is only true if the stylus is over the element. Jeśli pióro znajduje się nad elementem podrzędnym lub przez elementy, które są częścią bardziej szczegółowego przenoszonego elementu (drzewo wizualne), ta właściwość będzie 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.

Jeśli nie wiesz, jak kontrolka jest złożona (na przykład można użyć tej właściwości w szablonie kontrolki niestandardowej dla zdefiniowanej kontrolki), ta właściwość może zwracać nieoczekiwane wyniki.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. W przypadku większości scenariuszy, w których nie tworzysz formantów, użyj IsStylusOver zamiast tego.For most scenarios where you are not authoring controls, use IsStylusOver instead.

Jeśli ten element ma funkcję przechwytywania pióra i ta właściwość jest true w czasie przechwytywania, ta właściwość pozostaje true do momentu utraty przechwycenia pióra, a pióro nie znajduje się nad jego zakresem.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.

W określonej relacji istnieje dotyk, mysz i dane wejściowe pióra.Touch, mouse, and stylus input exist in a particular relationship. Aby uzyskać więcej informacji, zobacz Informacje o danych wejściowych.For more information, see Input Overview.

Informacje dotyczące właściwości zależnościDependency Property Information

Pole identyfikatoraIdentifier field IsStylusDirectlyOverProperty
Właściwości metadanych ustawione na trueMetadata properties set to true BrakNone

Dotyczy

Zobacz też