UIElement.IsMouseOver Właściwość

Definicja

Pobiera wartość wskazującą, czy wskaźnik myszy znajduje się nad tym elementem (w tym elementami podrzędnymi w drzewie wizualnym).Gets a value indicating whether the mouse pointer is located over this element (including child elements in the visual tree). Jest to właściwość zależności.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

Wartość właściwości

true, jeśli wskaźnik myszy znajduje się nad elementem lub jego elementami podrzędnymi; w przeciwnym razie false.true if mouse pointer is over the element or its child elements; otherwise, false. Wartość domyślna to false.The default is false.

Implementuje

Przykłady

Poniższy przykład odwołuje się do tej właściwości jako typu właściwości Trigger, częścią stylu <. wyzwalacze >.The following example references this property as the property type of a Trigger, part of a <Style.Triggers> block. Jeśli wskaźnik myszy znajduje się nad kontrolką, tekst kontrolki zmieni się na niebieski, a kursor staje się ręką.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>

Uwagi

Zazwyczaj formanty są złożone w taki sposób, że różne elementy wewnątrz kontrolki (drzewo wizualne) będą raportować stan myszy dla zawierającej kontrolki.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. Na przykład, ListBox kontrolka stylu będzie raportować IsMouseOver jako true, jeśli mysz jest w dowolnym miejscu w geometrii, włącznie z dowolnym ListBoxItem.For example, a ListBox style control will report IsMouseOver as true if the mouse is anywhere over its geometry, including any ListBoxItem.

Chociaż analogiczne zdarzenie "IsMouseOverChanged" nie istnieje, można wykonać kilka podobnych zdarzeń.Although an analogous "IsMouseOverChanged" event does not exist, several similar events do. Można na przykład obsłużyć MouseEnter, MouseMovei IsMouseDirectlyOverChanged.For example, you can handle MouseEnter, MouseMove, and IsMouseDirectlyOverChanged.

Jeśli ten element przechwytuje mysz, ta właściwość pozostaje true do momentu utraty przechwytywania myszy, a wskaźnik myszy opuszcza granice elementu.If this element captures the mouse, this property remains true until mouse capture is lost and the mouse pointer leaves the element bounds.

Niektóre kontrolki celowo przechwytuje mysz po niektórych akcjach, które nie pojawiają się bezpośrednio nad myszą.Some controls deliberately capture the mouse on certain actions that do not appear to directly involve the mouse. Może to prowadzić do IsMouseOver true nawet wtedy, gdy mysz nie została przeniesiona.This can lead to IsMouseOver being true even though the mouse has not apparently moved.

Informacje dotyczące właściwości zależnościDependency Property Information

Pole identyfikatoraIdentifier field IsMouseOverProperty
Właściwości metadanych ustawione na trueMetadata properties set to true NoneNone

Dotyczy