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).Gets a value indicating whether the mouse pointer is located over this element (including child elements in the visual tree). Il s’agit d’une propriété de dépendance.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

Valeur de propriété

Boolean

true si le pointeur de la souris se trouve sur l’élément ou ses éléments enfants ; sinon, false.true if mouse pointer is over the element or its child elements; otherwise, false. La valeur par défaut est false.The default is false.

Implémente

Exemples

L’exemple suivant fait référence à cette propriété en tant que type de propriété d’un Trigger élément d’un <Style.Triggers> bloc.The following example references this property as the property type of a Trigger, part of a <Style.Triggers> block. Si la souris se trouve sur le contrôle, le texte du contrôle devient bleu et le curseur devient une main.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>

Remarques

En règle générale, les contrôles sont composés de telle sorte que les différents éléments à l’intérieur du contrôle (l’arborescence d’éléments visuels) signalent tous l’état de la souris pour le contrôle conteneur.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. Par exemple, un ListBox contrôle de style sera signalé IsMouseOver comme true si la souris se trouvait n’importe où sur sa géométrie, y compris les autres ListBoxItem .For example, a ListBox style control will report IsMouseOver as true if the mouse is anywhere over its geometry, including any ListBoxItem.

Bien qu’il n’existe pas d’événement « IsMouseOverChanged » analogue, plusieurs événements similaires le font.Although an analogous "IsMouseOverChanged" event does not exist, several similar events do. Par exemple, vous pouvez gérer MouseEnter , MouseMove et IsMouseDirectlyOverChanged .For example, you can handle MouseEnter, MouseMove, and 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.If this element captures the mouse, this property remains true until mouse capture is lost and the mouse pointer leaves the element bounds.

Certains contrôles capturent délibérément la souris sur certaines actions qui ne semblent pas impliquer directement la souris.Some controls deliberately capture the mouse on certain actions that do not appear to directly involve the mouse. Cela peut entraîner IsMouseOver true la non-déplacement de la souris.This can lead to IsMouseOver being true even though the mouse has not apparently moved.

Informations sur les propriétés de dépendanceDependency Property Information

Champ d’identificateurIdentifier field IsMouseOverProperty
Propriétés de métadonnées définies sur trueMetadata properties set to true AucunNone

S’applique à