UIElement.IsMouseOver Eigenschaft
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
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
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 |