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 |
Нет |