ContentElement.OnPreviewMouseLeftButtonUp(MouseButtonEventArgs) 方法


当某个未处理的 PreviewMouseLeftButtonUp 路由事件在其路由中到达派生自此类的某个元素时调用。Invoked when an unhandled PreviewMouseLeftButtonUp routed event reaches an element in its route that is derived from this class. 实现此方法可为此事件添加类处理。Implement this method to add class handling for this event.

protected public:
 virtual void OnPreviewMouseLeftButtonUp(System::Windows::Input::MouseButtonEventArgs ^ e);
protected internal virtual void OnPreviewMouseLeftButtonUp (System.Windows.Input.MouseButtonEventArgs e);
abstract member OnPreviewMouseLeftButtonUp : System.Windows.Input.MouseButtonEventArgs -> unit
override this.OnPreviewMouseLeftButtonUp : System.Windows.Input.MouseButtonEventArgs -> unit
Protected Friend Overridable Sub OnPreviewMouseLeftButtonUp (e As MouseButtonEventArgs)



包含事件数据的 MouseButtonEventArgsThe MouseButtonEventArgs that contains the event data. 事件数据报告称已松开鼠标左键。The event data reports that the left mouse button was released.


PreviewMouseLeftButtonUp事件看起来是传递隧道路由,但实际以间接方式传播。The PreviewMouseLeftButtonUp event appears to travel a tunneling route but actually travels in an indirect way. Mouse.PreviewMouseUp 是隧道路由的基础事件,每个事件 ContentElement 路由沿事件路由都使用相同的处理来引发直接路由事件 PreviewMouseLeftButtonUpMouse.PreviewMouseUp is the underlying event that is tunnel routed, and each ContentElement along the event route uses identical handling to raise the direct routed event PreviewMouseLeftButtonUp. 虽然您可以将 PreviewMouseLeftButtonUp 事件标记为已处理,以便进行此元素,但已处理状态并不保持事件路由中的其他元素。Although you can mark the PreviewMouseLeftButtonUp event as handled for purposes of this element, the handled state does not perpetuate to other elements along the event route. 但是,你可能需要将事件标记为已处理,以防止常规实例处理程序 (未指定调用) 的实例处理程序 handledEventsTooHowever, you might want to mark the event as handled in order to prevent general instance handlers (those that did not specify handledEventsToo) from being invoked.

中的常规鼠标事件处理的默认实现 ContentElement 将侦听 Mouse.PreviewMouseUp 并将其转换为适当的本地事件。The default implementation for general mouse event handling in ContentElement listens for Mouse.PreviewMouseUp and converts it to an appropriate local event. 如果要重写此逻辑,必须创建派生类。If you want to override this logic, you must create a derived class. 在派生类的静态构造函数中,为注册替代类处理程序 Mouse.PreviewMouseUpIn the static constructor of your derived class, register an alternative class handler for Mouse.PreviewMouseUp. 不能 ContentElement 通过重写来更改的鼠标处理行为 OnPreviewMouseLeftButtonUpYou cannot change the mouse handling behavior of ContentElement by overriding OnPreviewMouseLeftButtonUp.