UIElement.IsMouseDirectlyOver Eigenschaft

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 IsMouseOverwird diese Eigenschaft nur true, wenn sich der Mauszeiger über dem Literalelement befindet, wie es bei einem Treffer Test der Fall ist.Unlike IsMouseOver, this property is only true if the mouse pointer is over the literal element - as it is for a hit test. Wenn sich der Mauszeiger stattdessen über einem untergeordneten Element befindet, insbesondere über Elemente, die Teil der tieferen Vorlage eines Elements und der Zusammensetzung sind, wird diese Eigenschaft 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. Wenn Sie nicht wissen, wie ein Steuerelement zusammengesetzt ist (z. b. verwenden Sie diese Eigenschaft in einer benutzerdefinierten Steuerelement Vorlage für ein Steuerelement, das Sie definieren), gibt diese Eigenschaft möglicherweise unerwartete Ergebnisse zurück.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 denen Sie keine Steuerelemente erstellen, stattdessen IsMouseOver.For most scenarios where you are not authoring controls, use IsMouseOver instead.

Wenn die Maus von diesem Element aufgezeichnet wird und diese Eigenschaft zum Zeitpunkt der Erfassung true wird, gibt diese Eigenschaft weiterhin true zurück, bis die Maus Aufzeichnung verloren geht und sich der Zeiger nicht über dessen Begrenzungen befindet.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

BezeichnerfeldIdentifier field IsMouseDirectlyOverProperty
Metadateneigenschaften auf true festgelegtMetadata properties set to true KeineNone

Gilt für:

Siehe auch