UIElement.IsMouseOver Свойство

Определение

Получает значение, указывающее, находится ли указатель мыши над данным элементом (включая дочерние элементы в визуальном дереве). Это свойство зависимостей.

public:
 property bool IsMouseOver { bool get(); };
public bool IsMouseOver { get; }
member this.IsMouseOver : bool
Public ReadOnly Property IsMouseOver As Boolean

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

Значение true, если указатель мыши находится над элементом или его дочерними элементами; в противном случае — значение false. Значение по умолчанию — false.

Реализации

Примеры

В следующем примере это свойство ссылается как на тип Triggerсвойства , часть <блока Style.Triggers> . Если указатель мыши находится над элементом управления, текст элемента управления становится синим, а курсор становится рукой.

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

Комментарии

Как правило, элементы управления композитируются таким образом, что различные элементы внутри элемента управления (визуальное дерево) будут сообщать о состоянии мыши для содержащего элемента управления. Например, элемент управления стилем ListBox будет сообщать, IsMouseOver как true будто указатель мыши находится в любом месте своей геометрии, включая любой ListBoxItem.

Хотя аналогичного события IsMouseOverChanged не существует, существует несколько аналогичных событий. Например, можно обрабатывать MouseEnter, MouseMoveи IsMouseDirectlyOverChanged.

Если этот элемент захватывает мышь, это свойство сохраняется true до тех пор, пока захват мыши не будет потерян, а указатель мыши не покинет границы элемента.

Некоторые элементы управления намеренно захватывают мышь при определенных действиях, которые, как представляется, не связаны непосредственно с мышью. Это может привести к IsMouseOver тому, что true мышь не переместилась.

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

Поле идентификатора IsMouseOverProperty
Для свойств метаданных задано значение true Нет

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