UIElement.IsMouseOver Właściwość

Definicja

Przestrzeń nazw:

System.Windows

Zestaw:

PresentationCore.dll

Pobiera wartość wskazującą, czy wskaźnik myszy znajduje się nad tym elementem (w tym elementami podrzędnymi w drzewie wizualizacji). Jest to właściwość zależności.

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

Boolean

true jeśli wskaźnik myszy znajduje się na elemecie lub jego elementach podrzędnych; w przeciwnym razie , false. Wartość domyślna to false.

Implementuje

IsMouseOver

Przykłady

Poniższy przykład odwołuje się do tej właściwości jako typu Triggerwłaściwości bloku <Style.Triggers> . Jeśli mysz jest nad kontrolką, tekst kontrolki zmieni kolor na niebieski, a kursor stanie się ręką.

<Trigger Property="IsMouseOver" Value="true">
  <Setter Property="Foreground" Value="Blue" />
  <Setter Property="Cursor" Value="Hand"/>
</Trigger>

Uwagi

Zazwyczaj kontrolki są złożone, tak aby różne elementy wewnątrz kontrolki (drzewa wizualnego) wszystkie zgłaszały stan myszy dla kontrolki zawierającej. Na przykład kontrolka ListBox stylu będzie zgłaszać IsMouseOver , jakby true mysz znajduje się w dowolnym miejscu nad jego geometrią, w tym dowolną ListBoxItem.

Chociaż analogiczne zdarzenie "IsMouseOverChanged" nie istnieje, kilka podobnych zdarzeń nie istnieje. Można na przykład obsługiwać MouseEnter, MouseMovei IsMouseDirectlyOverChanged.

Jeśli ten element przechwytuje mysz, ta właściwość pozostaje do true momentu utraty przechwycenia myszy, a wskaźnik myszy pozostawia granice elementu.

Niektóre kontrolki celowo przechwytują mysz na niektórych akcjach, które nie wydają się bezpośrednio obejmować myszy. Może to prowadzić do IsMouseOver bycia true nawet wtedy, gdy mysz najwyraźniej nie została przeniesiona.

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

Pole identyfikatora	IsMouseOverProperty
Właściwości metadanych ustawione na true	Brak