Partager via


UIElement.IsMouseOver Propriété

Définition

Obtient une valeur indiquant si le pointeur de la souris se trouve sur cet élément (notamment les éléments enfants dans l’arborescence d’éléments visuel). Il s’agit d’une propriété de dépendance.

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é en tant que type de propriété d’un Trigger, faisant partie d’un <bloc Style.Triggers> . Si la souris est au-dessus du 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 composés 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 indique IsMouseOver que true la souris se trouve n’importe où au-dessus de sa géométrie, y compris .ListBoxItem

Bien qu’il n’existe pas d’événement analogue « IsMouseOverChanged », 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 ne semblent pas impliquer directement la souris. Cela peut conduire à IsMouseOver être true même si la souris n’a apparemment pas bougé.

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

Champ Identificateur IsMouseOverProperty
Propriétés de métadonnées définies sur true Aucun

S’applique à