UIElement.IsMouseOver Eigenschaft

Definition

Namespace:

System.Windows

Assembly:

PresentationCore.dll

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

IsMouseOver

Beispiele

Das folgende Beispiel verweist auf diese Eigenschaft als Eigenschaftstyp eines TriggerTeils eines <Style.Triggers-Blocks> . Wenn sich die Maus über dem Steuerelement befindet, wird der Steuertext 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 so zusammengesetzt, dass die verschiedenen Elemente innerhalb des Steuerelements (die visuelle Struktur) alle den Mauszustand für das enthaltende Steuerelement melden. Ein Formatvorlagensteuerelement meldet IsMouseOver beispielsweise, ListBox als true ob sich die Maus an einer beliebigen Stelle über seiner Geometrie befindet, einschließlich einer beliebigen ListBoxItem.

Obwohl ein analoges "IsMouseOverChanged"-Ereignis nicht vorhanden ist, gibt es mehrere ähnliche Ereignisse. Sie können z. B. , MouseMoveund IsMouseDirectlyOverChangedbehandelnMouseEnter.

Wenn dieses Element die Maus erfasst, bleibt diese Eigenschaft so true lange erhalten, bis die Mausaufnahme verloren geht und der Mauszeiger die Elementgrenzen verlässt.

Einige Steuerelemente erfassen die Maus bewusst bei bestimmten Aktionen, die die Maus nicht direkt betreffen. Dies kann dazu führen, IsMouseOver dass sich true die Maus anscheinend nicht bewegt hat.

Informationen zur Abhängigkeitseigenschaft

Bezeichnerfeld	IsMouseOverProperty
Metadateneigenschaften auf true festgelegt	Keine