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.

Несмотря на то, что аналогично событие «IsMouseOverChanged» не существует, выполните несколько аналогичных событий.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 NoneNone

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