UIElement.IsMouseOver UIElement.IsMouseOver UIElement.IsMouseOver UIElement.IsMouseOver Property

Определение

Получает значение, указывающее, находится ли указатель мыши над данным элементом (включая дочерние элементы в визуальном дереве).Gets a value indicating whether the mouse pointer is located over this element (including child elements in the visual tree). Это свойство зависимостей.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

Значение свойства

Значение true, если указатель мыши находится над элементом или его дочерними элементами; в противном случае — значение false.true if mouse pointer is over the element or its child elements; otherwise, false. Значение по умолчанию — false.The default is false.

Реализации

Примеры

Следующий пример ссылается на это свойство как на тип Triggerсвойства, часть <Style. triggers > блоке.The following example references this property as the property type of a Trigger, part of a <Style.Triggers> block. Если указатель мыши находится над элементом управления, то текст элемента управления становится синим, а курсор — рукой.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>

Комментарии

Как правило, элементы управления являются составными, так что различные элементы внутри элемента управления (визуальное дерево) будут сообщать о состоянии мыши для содержащего его элемента управления.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. Например, ListBox элемент управления "стиль" будет IsMouseOver сообщать, как true если бы мышь находилась в любом ListBoxItemместе над его геометрической фигурой, включая любые.For example, a ListBox style control will report IsMouseOver as true if the mouse is anywhere over its geometry, including any ListBoxItem.

Хотя аналогичное событие «Исмаусеоверчанжед» не существует, выполняется несколько аналогичных событий.Although an analogous "IsMouseOverChanged" event does not exist, several similar events do. Например, можно выполнять обработку MouseEnter, MouseMoveи IsMouseDirectlyOverChanged.For example, you can handle MouseEnter, MouseMove, and IsMouseDirectlyOverChanged.

Если этот элемент захватывает мышь, это свойство сохраняется true до тех пор, пока захват мыши не будет потерян и указатель мыши покидает границы элемента.If this element captures the mouse, this property remains true until mouse capture is lost and the mouse pointer leaves the element bounds.

Некоторые элементы управления намеренно захватывают мышь над определенными действиями, которые не связаны непосредственно с мышью.Some controls deliberately capture the mouse on certain actions that do not appear to directly involve the mouse. Это может привести к IsMouseOver тому true , что мышь не перемещалась.This can lead to IsMouseOver being true even though the mouse has not apparently moved.

Сведения о свойстве зависимостейDependency Property Information

Поле идентификатораIdentifier field IsMouseOverProperty
Свойства метаданных, для которых задано значениеtrueMetadata properties set to true НетNone

Применяется к