UIElement.IsMouseOver UIElement.IsMouseOver UIElement.IsMouseOver UIElement.IsMouseOver Property

Definition

Ruft einen Wert ab, der angibt, ob sich der Mauszeiger über diesem Element (einschließlich der untergeordneten Elemente in der visuellen Struktur) befindet.Gets a value indicating whether the mouse pointer is located over this element (including child elements in the visual tree). Hierbei handelt es sich um eine Abhängigkeitseigenschaft.This is a dependency property.

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

Eigenschaftswert

true, wenn sich der Mauszeiger über dem Element oder seinen untergeordneten Elementen befindet, andernfalls false.true if mouse pointer is over the element or its child elements; otherwise, false. Die Standardeinstellung ist false.The default is false.

Implementiert

Beispiele

Im folgende Beispiel verweist diese Eigenschaft auf, weil der Eigenschaftentyp des eine Trigger, der Teil einer <Style.Triggers > Block.The following example references this property as the property type of a Trigger, part of a <Style.Triggers> block. Wenn der Mauszeiger über dem Steuerelement befindet, der Steuerelementtext Blau, und der Mauszeiger als Hand.If the mouse is over the control, the control text turns blue and the cursor becomes a hand.

<Trigger Property="IsMouseOver" Value="true">
  <Setter Property="Foreground" Value="Blue" />
  <Setter Property="Cursor" Value="Hand"/>
</Trigger>

Hinweise

In der Regel sind Steuerelemente so zusammengesetzt, dass die verschiedenen Elemente innerhalb des Steuerelements (der visuellen Struktur) werden den Zustand von Mauseingaben für das enthaltende Steuerelement melden.Typically, controls are composited such that the various elements inside the control (the visual tree) will all report the mouse state for the containing control. Z. B. eine ListBox Steuerelement Stil meldet IsMouseOver als true , wenn der Mauszeiger an einer beliebigen Stelle Geometrie befindet, einschließlich aller ListBoxItem.For example, a ListBox style control will report IsMouseOver as true if the mouse is anywhere over its geometry, including any ListBoxItem.

Obwohl ein Analog "IsMouseOverChanged"-Ereignis nicht vorhanden ist, sind mehrere ähnliche Ereignisse auf.Although an analogous "IsMouseOverChanged" event does not exist, several similar events do. Sie können z. B. behandeln MouseEnter, MouseMove, und IsMouseDirectlyOverChanged.For example, you can handle MouseEnter, MouseMove, and IsMouseDirectlyOverChanged.

Wenn dieses Element die Mausauswahl erhält, wird diese Eigenschaft bleibt true bis Mausauswahl verloren, und der Mauszeiger der Grenzen des Elements verlässt.If this element captures the mouse, this property remains true until mouse capture is lost and the mouse pointer leaves the element bounds.

Einige Steuerelemente erfasst absichtlich die Maus auf bestimmte Aktionen, die nicht angezeigt werden, auf die Maus direkt betreffen.Some controls deliberately capture the mouse on certain actions that do not appear to directly involve the mouse. Dies kann dazu führen IsMouseOver wird true , obwohl das anscheinend nicht die Maus bewegt wurde.This can lead to IsMouseOver being true even though the mouse has not apparently moved.

Informationen zur AbhängigkeitseigenschaftDependency Property Information

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

Gilt für: