UIElement.IsMouseDirectlyOver Właściwość

Definicja

Pobiera wartość wskazującą, czy pozycja wskaźnika myszy odnosi się do wyników testu trafień, które przynoszą do konta.Gets a value that indicates whether the position of the mouse pointer 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 IsMouseDirectlyOver { bool get(); };
public bool IsMouseDirectlyOver { get; }
member this.IsMouseDirectlyOver : bool
Public ReadOnly Property IsMouseDirectlyOver 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 mouse 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 IsMouseOver , ta właściwość jest tylko wtedy, true gdy wskaźnik myszy znajduje się nad elementem literału — jako dla testu trafień.Unlike IsMouseOver, this property is only true if the mouse pointer is over the literal element - as it is for a hit test. Jeśli wskaźnik myszy znajduje się nad elementem podrzędnym, w szczególności dla elementów, które są częścią bardziej szczegółowego szablonu i przedniego elementu, ta właściwość będzie 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. 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 IsMouseOver zamiast tego.For most scenarios where you are not authoring controls, use IsMouseOver instead.

Jeśli wskaźnik myszy jest przechwytywany przez ten element i ta właściwość jest true w czasie przechwytywania, ta właściwość będzie nadal zwracana, true dopóki przechwycenie myszy nie zostanie utracone i wskaźnik nie znajduje się nad jego zakresem.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.

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

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

Dotyczy

Zobacz też