UIElement.PreviewMouseLeftButtonDown 事件

定义

在鼠标指针位于此元素上并且按下鼠标左键时发生。

public:
 virtual event System::Windows::Input::MouseButtonEventHandler ^ PreviewMouseLeftButtonDown;
public event System.Windows.Input.MouseButtonEventHandler PreviewMouseLeftButtonDown;
member this.PreviewMouseLeftButtonDown : System.Windows.Input.MouseButtonEventHandler 
Public Custom Event PreviewMouseLeftButtonDown As MouseButtonEventHandler 

事件类型

实现

注解

尽管此 路由事件 似乎遵循通过元素树的隧道路由,但它实际上是一个直接路由事件,由每个 UIElement引发并沿元素树重新引发。

此事件是报告基础 Mouse.PreviewMouseDown 事件的鼠标按钮细节的几个相关事件之一,该事件是事件路由中每个元素处理的附加事件。

此事件的事件数据公开基础 Mouse.PreviewMouseDown 事件的事件数据。 如果该事件被标记为沿事件路由处理,则仍会引发特定于鼠标按钮的事件;但是,必须通过显式调用 AddHandler来添加鼠标按钮特定事件的处理程序,并可以选择处理已标记为已处理的事件,以便成为事件的侦听器。 如果将“已处理”标记为 PreviewMouseLeftButtonDown “已处理”,则实质上是针对路由中的所有后续侦听器以及所有相关事件标记为 Mouse.PreviewMouseDown 已处理。 这可能包括类处理程序生成的事件,例如 PreviewMouseDoubleClick

从概念上讲,将此事件 (和) 上的 UIElement 其他鼠标按钮事件视为鼠标“服务” (与 类) 提供的服务 Mouse 定义。 事件增加了无需检查鼠标按钮状态的便利性, (事件数据中原始鼠标事件的左、右、上、下) 。 对于更高级的方案(例如检查非标准按钮的状态),可能需要使用 类上的 Mouse API,而不是 上的 UIElementAPI。

路由事件信息

标识符字段 PreviewMouseLeftButtonDownEvent
路由策略 直接
委托 MouseButtonEventHandler

适用于

另请参阅