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

Boolean

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. Der Standardwert ist false.The default is false.

Implementiert

Beispiele

Im folgenden Beispiel wird auf diese Eigenschaft als Eigenschaftentyp eines-Teils eines- Trigger <Style.Triggers> Blocks verwiesen.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. Ein Formatvorlagen ListBox Steuerelement meldet z. b IsMouseOver true ., als ob sich die Maus an einer beliebigen Stelle über der 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 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 , und behandeln MouseMove IsMouseDirectlyOverChanged .For example, you can handle MouseEnter, MouseMove, and IsMouseDirectlyOverChanged.

Wenn dieses Element die Maus erfasst, bleibt diese Eigenschaft erhalten, 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 zu IsMouseOver sein, true Obwohl 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: