UIElement.OnMouseUp(MouseButtonEventArgs) UIElement.OnMouseUp(MouseButtonEventArgs) UIElement.OnMouseUp(MouseButtonEventArgs) UIElement.OnMouseUp(MouseButtonEventArgs) Method

Definición

Se invoca cuando un evento enrutado MouseUp no controlado alcanza un elemento derivado de esta clase en su ruta.Invoked when an unhandled MouseUp routed event reaches an element in its route that is derived from this class. Implemente este método a fin de agregar el control de clases para este evento.Implement this method to add class handling for this event.

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

Parámetros

e
MouseButtonEventArgs MouseButtonEventArgs MouseButtonEventArgs MouseButtonEventArgs

Objeto MouseButtonEventArgs que contiene los datos del evento.The MouseButtonEventArgs that contains the event data. Los datos del evento informan de que se soltó el botón del mouse.The event data reports that the mouse button was released.

Comentarios

Acciones de botón del mouse también se controlan mediante un administrador de entrada dedicado.Mouse button actions are also handled by a dedicated input manager. Otras características de programación que se basan en acciones de botón del mouse, como entrada y enlaces de comandos, pueden invocar controladores para la acción antes de se expone como una acción del botón del mouse general.Other programming features that rely on mouse button actions, such as input and command bindings, might invoke handlers for the action before it is exposed as a general mouse button action. Si estos marca de características del sistema de entrada la Mouse.MouseUp evento como controlado, OnMouseUp no se invoca.If these input system features mark the Mouse.MouseUp event as handled, OnMouseUp is not invoked.

Si usa este controlador de clase para marcar el evento como controlado, podría afectar los siguientes eventos: MouseLeftButtonUp y MouseRightButtonUp.If you use this class handler to mark the event as handled, you potentially impact the following events: MouseLeftButtonUp and MouseRightButtonUp. Cualquiera de estos eventos pueden generarse en el elemento receptor cuando Mouse.MouseUp se recibe.Either of these events might be raised on the receiving element when Mouse.MouseUp is received.

Si marca este evento como controlado en el control de clases, se generan eventos secundarios; Sin embargo, pasan el estado controlado en los datos del evento.If you mark this event as handled in class handling, subevents are still raised; however, they pass the handled state in the event data. Si el evento se controla en el control de clases, no se invocan controladores de instancia para los eventos secundarios a menos que use explícitamente AddHandler(RoutedEvent, Delegate, Boolean) con handledEventsToo true con el fin de asociar controladores.If the event is handled in class handling, instance handlers for the subevents are not invoked unless you explicitly use AddHandler(RoutedEvent, Delegate, Boolean) with handledEventsToo true in order to attach handlers. Los controladores de clase también no se invocan a menos que se registraron los controladores de clases con el RegisterClassHandler(Type, RoutedEvent, Delegate, Boolean) firma con handledEventsToo true.Class handlers also are not invoked unless those class handlers were registered with the RegisterClassHandler(Type, RoutedEvent, Delegate, Boolean) signature with handledEventsToo true. Controlando OnMouseUp, son lo que implica que tienen en cuenta el control de clases para todas las acciones de soltar el botón del mouse posibles.By handling OnMouseUp, you are implying that your class handling accounted for all possible mouse button up actions. Este comportamiento podría ser no deseada; Por lo tanto, tenga cuidado cuando use este método virtual para marcar eventos como controlados.This behavior might be unwanted; Therefore, use caution when you use this virtual method to mark events as handled.

Cada uno de los eventos directos específicos de los botones también tiene un virtual * método; Tenga en cuenta si reemplazar estos controladores de clase específica del botón puede ser más adecuado.Each of the button-specific direct events also has a virtual On* method; consider whether overriding these button-specific class handlers might be more appropriate.

Este método no tiene ninguna implementación predeterminada.This method has no default implementation. Dado que una clase intermedia en la herencia podría implementar este método, se recomienda que llame a la implementación base en su implementación.Because an intermediate class in the inheritance might implement this method, we recommend that you call the base implementation in your implementation.

El propósito de este método es similar a la Common Language Runtime (CLR)common language runtime (CLR) patrón de eventos en * métodos: este método proporciona los medios para controlar el evento correspondiente de las clases derivadas mediante el establecimiento de un controlador de clase en lugar de un controlador de instancia.The purpose of this method is similar to the Common Language Runtime (CLR)common language runtime (CLR) event pattern On* methods: this method provides the means to handle the matching event from derived classes by establishing a class handler instead of an instance handler. En este caso, el evento correspondiente es un evento enrutado.In this case the matching event is a routed event. El modelo de implementación de los métodos On * es diferente para los eventos enrutados porque puede generarse un evento enrutado por un elemento secundario, que no es necesariamente el elemento que va a invocar los controladores.The implementation pattern of the On* methods is different for routed events because a routed event can be raised by a child element, which is not necessarily the element that will invoke handlers. Por lo tanto, la implementación debe examinar las propiedades del origen de los datos del evento.Therefore, your implementation needs to examine the source properties of the event data. No debe intentar reraise () el evento en la mayoría de los casos.It should not try to reraise the event in most cases.

Invalidando este método o mediante el registro de controladores con la clase RegisterClassHandler, las clases derivadas de UIElement puede llamar a métodos de controlador de clase privada cuando se recibe el evento a lo largo de la ruta del evento.Either by overriding this method or by registering class handlers with RegisterClassHandler, derived classes of UIElement can call private class handler methods when the event is received along the event route. Es un escenario donde el control de clases es adecuado manipular los datos del evento y marcar el evento enrutado como controlado.One scenario where class handling is appropriate is to manipulate the event data and mark the routed event as handled.

Se aplica a