UIElement.IsMouseDirectlyOver UIElement.IsMouseDirectlyOver UIElement.IsMouseDirectlyOver UIElement.IsMouseDirectlyOver Property

Definition

Ruft einen Wert ab, der angibt, ob die Position des Mauszeigers den Treffertestergebnissen entspricht, für die die Elementzusammensetzung berücksichtigt wird.Gets a value that indicates whether the position of the mouse pointer corresponds to hit test results, which take element compositing into account. Hierbei handelt es sich um eine Abhängigkeitseigenschaft.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

Eigenschaftswert

true, wenn sich der Mauszeiger über demselben Elementergebnis wie ein Treffertest befindet, andernfalls false.true if the mouse pointer is over the same element result as a hit test; otherwise, false. Die Standardeinstellung ist false.The default is false.

Implementiert

Hinweise

Im Gegensatz zu IsMouseOver, diese Eigenschaft ist nur true , wenn der Mauszeiger über dem literal-Element - befindet, als auch für einen Treffertest.Unlike IsMouseOver, this property is only true if the mouse pointer is over the literal element - as it is for a hit test. Wenn der Mauszeiger stattdessen über ein untergeordnetes Element enthalten ist, insbesondere über Elemente, die Teil eines Elements umfangreichere Vorlage und Zusammensetzung zu dieser Eigenschaft werden 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. Es sei denn, Sie wissen, wie ein Steuerelement so zusammengesetzt ist (z. B. Sie verwenden diese Eigenschaft in einer benutzerdefinierten Steuerelementvorlage für ein Steuerelement, das Sie definieren), diese Eigenschaft möglicherweise unerwartete Ergebnisse zurückgeben.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. Verwenden Sie für die meisten Szenarien, in dem Sie keine Steuerelemente erstellt werden, IsMouseOver stattdessen.For most scenarios where you are not authoring controls, use IsMouseOver instead.

Wenn die Maus von diesem Element erfasst wird, und diese Eigenschaft ist true zum Zeitpunkt der Erfassung, diese Eigenschaft wird weiterhin zurück true bis Mausauswahl verloren, und der Zeiger nicht über die Grenzen ist.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.

Informationen zur AbhängigkeitseigenschaftDependency Property Information

Feld "ID"Identifier field IsMouseDirectlyOverProperty
Legen Sie auf der Metadaten-Eigenschaften trueMetadata properties set to true KeinerNone

Gilt für:

Siehe auch