UIElement.OnTextInput(TextCompositionEventArgs) Metodo

Definizione

Viene richiamato ogni volta che un evento associato TextInput non gestito raggiunge un elemento nella propria route derivato da questa classe.Invoked when an unhandled TextInput 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:
 virtual void OnTextInput(System::Windows::Input::TextCompositionEventArgs ^ e);
protected virtual void OnTextInput (System.Windows.Input.TextCompositionEventArgs e);
abstract member OnTextInput : System.Windows.Input.TextCompositionEventArgs -> unit
override this.OnTextInput : System.Windows.Input.TextCompositionEventArgs -> unit
Protected Overridable Sub OnTextInput (e As TextCompositionEventArgs)

Parametri

e
TextCompositionEventArgs

Oggetto TextCompositionEventArgs che contiene i dati dell'evento.The TextCompositionEventArgs that contains the event data.

Commenti

Questo metodo non ha un'implementazione predefinita.This method has no default implementation. Poiché una classe intermedia nell'ereditarietà può implementare questo metodo, è consigliabile chiamare l'implementazione di base nell'implementazione di.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 modello di evento Common Language Runtime (CLR)common language runtime (CLR) nei metodi *: questo metodo fornisce i mezzi per gestire l'evento di corrispondenza dalle classi derivate mediante la definizione di un gestore di classi invece di un gestore di istanza.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 dei metodi on * è diverso per gli eventi indirizzati perché un evento indirizzato può essere generato da un elemento figlio, che non è necessariamente l'elemento che richiamerà 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à di origine dei dati dell'evento.Therefore, your implementation needs to examine the source properties of the event data. Non tentare di 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 registrando gestori di classi con RegisterClassHandler, le classi derivate di UIElement possono chiamare metodi gestore di classi private quando l'evento viene ricevuto lungo la route dell'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. Uno scenario in cui la gestione delle classi è appropriata è modificare i dati degli eventi 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