UIElement.IsMouseOver Propriété

public:
 property bool IsMouseOver { bool get(); };

public bool IsMouseOver { get; }

member this.IsMouseOver : bool

Public ReadOnly Property IsMouseOver As Boolean

Valeur de propriété

true si le pointeur de la souris se trouve sur l’élément ou ses éléments enfants ; sinon, false. La valeur par défaut est false.

Implémente

Exemples

L’exemple suivant référence cette propriété comme type de propriété d’un Trigger<bloc Style.Triggers>. Si la souris est sur le contrôle, le texte du contrôle devient bleu et le curseur devient une main.

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

Remarques

En règle générale, les contrôles sont composites de sorte que les différents éléments à l’intérieur du contrôle (l’arborescence visuelle) signalent tous l’état de la souris pour le contrôle conteneur. Par exemple, un ListBox contrôle de style signale IsMouseOver comme true si la souris se trouve n’importe où sur sa géométrie, y compris n’importe quel ListBoxItem.

Bien qu’un événement « IsMouseOverChanged » analogue n’existe pas, plusieurs événements similaires le font. Par exemple, vous pouvez gérer MouseEnter, MouseMoveet IsMouseDirectlyOverChanged.

Si cet élément capture la souris, cette propriété reste true jusqu’à ce que la capture de la souris soit perdue et que le pointeur de la souris quitte les limites de l’élément.

Certains contrôles capturent délibérément la souris sur certaines actions qui n’apparaissent pas directement impliquer la souris. Cela peut conduire à IsMouseOver être true même si la souris n’a pas apparemment déplacé.

Informations sur les propriétés de dépendance