UIElement.IsMouseOver Eigenschaft

Definition

Ruft einen Wert ab, der angibt, ob sich der Mauszeiger über diesem Element (einschließlich der untergeordneten Elemente in der visuellen Struktur) befindet. Hierbei handelt es sich um eine Abhängigkeitseigenschaft.

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

Eigenschaftswert

Boolean

true, wenn sich der Mauszeiger über dem Element oder seinen untergeordneten Elementen befindet, andernfalls false. Der Standardwert ist false.

Implementiert

Beispiele

Im folgenden Beispiel wird diese Eigenschaft als Eigenschaftentyp eines TriggerBlockteils <Style.Triggers> verwiesen. Wenn die Maus über das Steuerelement liegt, wird der Steuerelementtext blau, und der Cursor wird zu einer Hand.

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

Hinweise

In der Regel werden Steuerelemente zusammengesetzt, sodass die verschiedenen Elemente innerhalb des Steuerelements (die visuelle Struktur) den Mauszustand für das enthaltende Steuerelement melden. Ein Formatvorlagensteuerelement meldet beispielsweiseListBox, als true ob sich die Maus an einer beliebigen Stelle über der Geometrie befindet, einschließlich einer beliebigenListBoxItem.IsMouseOver

Obwohl ein analoges "IsMouseOverChanged"-Ereignis nicht vorhanden ist, führen mehrere ähnliche Ereignisse aus. Sie können z. B. behandeln MouseEnter, MouseMoveund IsMouseDirectlyOverChanged.

Wenn dieses Element die Maus erfasst, bleibt true diese Eigenschaft erhalten, bis die Mausaufnahme verloren geht, und der Mauszeiger verlässt die Grenzen des Elements.

Einige Steuerelemente erfassen die Maus absichtlich auf bestimmte Aktionen, die nicht direkt in die Maus einbezogen werden. Dies kann dazu führen, IsMouseOver true dass die Maus nicht offensichtlich verschoben wird.

Informationen zur Abhängigkeitseigenschaft

Bezeichnerfeld IsMouseOverProperty
Metadateneigenschaften auf true festgelegt Keine

Gilt für: