ContentElement.OnPreviewMouseUp(MouseButtonEventArgs) ContentElement.OnPreviewMouseUp(MouseButtonEventArgs) ContentElement.OnPreviewMouseUp(MouseButtonEventArgs) ContentElement.OnPreviewMouseUp(MouseButtonEventArgs) Method

Definizione

Viene richiamato ogni qualvolta un evento PreviewMouseUp connesso non gestito raggiunge un elemento nella propria route derivato da questa classe.Invoked when an unhandled PreviewMouseUp attached event reaches an element in its route that is derived from this class. Implementare questo metodo per aggiungere la gestione delle classi per questo evento.Implement this method to add class handling for this event.

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

Parametri

e
MouseButtonEventArgs MouseButtonEventArgs MouseButtonEventArgs MouseButtonEventArgs

Oggetto MouseButtonEventArgs che contiene i dati dell'evento.The MouseButtonEventArgs that contains the event data. Nei dati degli eventi è indicato che stato rilasciato uno o più pulsanti del mouse.The event data reports that one or more mouse buttons were released.

Commenti

Azioni dei pulsanti del mouse vengono gestite anche tramite un gestore di input dedicato.Mouse button actions are also handled by a dedicated input manager. Altre funzionalità di programmazione che si basano su azioni dei pulsanti del mouse, ad esempio di input e di associazioni di comandi, può richiamare i gestori per l'azione prima che sia esposta come un'azione sul pulsante del mouse generale.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. Se questi input contrassegno di funzionalità del sistema di Mouse.PreviewMouseUp evento come gestito, OnPreviewMouseUp non viene richiamato.If these input system features mark the Mouse.PreviewMouseUp event as handled, OnPreviewMouseUp is not invoked.

Se si usa questo gestore classi per contrassegnare l'evento come gestito, potrebbe influire sugli eventi seguenti: PreviewMouseLeftButtonUp e PreviewMouseRightButtonUp.If you use this class handler to mark the event as handled, you potentially impact the following events: PreviewMouseLeftButtonUp and PreviewMouseRightButtonUp. Uno di questi eventi potrebbero essere generato nell'elemento ricevente quando Mouse.PreviewMouseUp viene ricevuto.Either of these events might be raised on the receiving element when Mouse.PreviewMouseUp is received.

Se si contrassegna questo evento come gestito nella gestione delle classi, secondari vengono comunque generati; Tuttavia, passano lo stato gestito nei dati dell'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. Se l'evento viene gestito nella gestione delle classi, a meno che non si scelga esplicitamente non vengono richiamati i gestori di istanze per gli eventi secondari AddHandler(RoutedEvent, Delegate, Boolean) con handledEventsToo true per associare i gestori.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. I gestori classi non vengono richiamati anche a meno che non sono stati registrati i gestori di classi con il 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. Gestendo OnPreviewMouseUp, si intende che la gestione delle classi di tutti i pulsanti del mouse possibili azioni.By handling OnPreviewMouseUp, you are implying that your class handling accounted for all possible mouse button up actions. Questo comportamento potrebbe risultare indesiderato; Pertanto, prestare attenzione quando si usa questo metodo virtuale per contrassegnare gli eventi come gestiti.This behavior might be unwanted; Therefore, use caution when you use this virtual method to mark events as handled.

Ognuno degli eventi diretti di specifici pulsante dispone anche di una virtuale su* metodo; considerare se si esegue l'override di questi gestori classi specifiche pulsante potrebbe essere più appropriato.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.

Questo metodo presenta alcuna implementazione predefinita.This method has no default implementation. Poiché una classe intermedia nell'ereditarietà potrà implementare questo metodo, si consiglia di chiamare l'implementazione di base nell'implementazione.Because an intermediate class in the inheritance might implement this method, we recommend that you call the base implementation in your implementation.

Lo scopo di questo metodo è simile al Common Language Runtime (CLR)common language runtime (CLR) schema di eventi su* metodi: questo metodo fornisce i mezzi per gestire l'evento corrispondente dalle classi derivate, stabilendo un gestore della classe anziché un gestore di istanze.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. In questo caso l'evento corrispondente è un evento indirizzato.In this case the matching event is a routed event. Il modello di implementazione di On* metodi è diversa per gli eventi indirizzati poiché un evento indirizzato può essere generato da un elemento figlio, che non corrisponde necessariamente all'elemento che richiama i gestori.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. Pertanto, l'implementazione deve esaminare le proprietà dell'origine dei dati dell'evento.Therefore, your implementation needs to examine the source properties of the event data. Consigliabile non rigenerare l'evento nella maggior parte dei casi.It should not try to reraise the event in most cases.

Eseguendo l'override di questo metodo o tramite la registrazione di gestori di classi con RegisterClassHandler, le classi derivate di ContentElement può chiamare metodi del gestore di classe privata quando viene ricevuto l'evento lungo la route dell'evento.Either by overriding this method or by registering class handlers with RegisterClassHandler, derived classes of ContentElement can call private class handler methods when the event is received along the event route. Uno scenario in cui la gestione di classi è appropriata consiste nel modificare i dati dell'evento e contrassegnare l'evento indirizzato come gestito.One scenario where class handling is appropriate is to manipulate the event data and mark the routed event as handled.

Si applica a

Vedi anche