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.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 folgenden Beispiel wird auf diese Eigenschaft als Eigenschaftentyp eines Triggerverwiesen, der Teil eines <Style. Triggers > Block ist.The following example references this property as the property type of a Trigger, part of a <Style.Triggers> block. Wenn sich der Mauszeiger über dem Steuerelement befindet, wird der Text des Steuer Elements blau, und der Cursor wird zu einer 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

Normalerweise werden Steuerelemente zusammengesetzt, sodass die verschiedenen Elemente innerhalb des Steuer Elements (der visuellen Struktur) den Maus Zustand 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. Beispielsweise meldet ein ListBox Stil-Steuerelement IsMouseOver als true, wenn sich der Mauszeiger über der Geometrie befindet, einschließlich sämtlicher 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 entsprechendes "ismouseoverchanged"-Ereignis nicht vorhanden ist, können mehrere ähnliche Ereignisse verwendet werden.Although an analogous "IsMouseOverChanged" event does not exist, several similar events do. Beispielsweise können Sie MouseEnter, MouseMoveund IsMouseDirectlyOverChangedverarbeiten.For example, you can handle MouseEnter, MouseMove, and IsMouseDirectlyOverChanged.

Wenn dieses Element die Maus erfasst, bleibt diese Eigenschaft true, bis die Maus Aufzeichnung verloren geht und der Mauszeiger die Elementgrenzen 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 erfassen absichtlich die Maus über bestimmte Aktionen, die anscheinend nicht direkt mit der Maus verbunden sind.Some controls deliberately capture the mouse on certain actions that do not appear to directly involve the mouse. Dies kann dazu führen, dass IsMouseOver true werden, auch wenn die Maus nicht anscheinend verschoben wurde.This can lead to IsMouseOver being true even though the mouse has not apparently moved.

Informationen zur AbhängigkeitseigenschaftDependency Property Information

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

Gilt für: