UIElement.IsMouseOver 属性
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
获取一个值,该值指示鼠标指针是否位于此元素(包括可视化树中的子元素)的上方。 这是依赖项属性。
public:
property bool IsMouseOver { bool get(); };
public bool IsMouseOver { get; }
member this.IsMouseOver : bool
Public ReadOnly Property IsMouseOver As Boolean
属性值
如果鼠标指针位于该元素或其子元素上方,则为 true
;否则为 false
。 默认值为 false
。
实现
示例
下面的示例引用此属性作为 Style.Triggers> 块的 Trigger<的属性类型。 如果鼠标悬停在控件上,控件文本将变为蓝色,光标变为手部。
<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
,直到鼠标捕获丢失并且鼠标指针离开元素边界。
某些控件在似乎不直接涉及鼠标的某些操作上故意捕获鼠标。 这可能会导致IsMouseOvertrue
即使鼠标显然没有移动。
依赖项属性信息
标识符字段 | IsMouseOverProperty |
元数据属性设置为 true |
无 |