UIElement.OnPreviewTextInput(TextCompositionEventArgs) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Viene richiamato ogni qualvolta un evento PreviewTextInput connesso non gestito raggiunge un elemento nella propria route derivato da questa classe. Implementare questo metodo per aggiungere la gestione delle classi per questo evento.
protected:
virtual void OnPreviewTextInput(System::Windows::Input::TextCompositionEventArgs ^ e);protected virtual void OnPreviewTextInput (System.Windows.Input.TextCompositionEventArgs e);abstract member OnPreviewTextInput : System.Windows.Input.TextCompositionEventArgs -> unit
override this.OnPreviewTextInput : System.Windows.Input.TextCompositionEventArgs -> unitProtected Overridable Sub OnPreviewTextInput (e As TextCompositionEventArgs)Parametri
Oggetto TextCompositionEventArgs che contiene i dati dell'evento.
Commenti
Questo metodo non ha alcuna implementazione predefinita. Poiché una classe intermedia nell'ereditarietà potrebbe implementare questo metodo, è consigliabile chiamare l'implementazione di base nell'implementazione.
Lo scopo di questo metodo è simile ai metodi CLR (Common Language Runtime): questo metodo fornisce i mezzi per gestire l'evento corrispondente da classi derivate creando un gestore di classi anziché un gestore di istanze. In questo caso l'evento corrispondente è un evento instradato. 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 richiama gestori. Pertanto, l'implementazione deve esaminare le proprietà di origine dei dati dell'evento. Non dovrebbe provare a riraizzare l'evento nella maggior parte dei casi.
Eseguendo l'override di questo metodo o registrando gestori di classi con RegisterClassHandlerclassi derivate di UIElement può chiamare i metodi del gestore della classe privata quando l'evento viene ricevuto lungo la route dell'evento. Uno scenario in cui la gestione delle classi è appropriata consiste nel modificare i dati dell'evento e contrassegnare l'evento indirizzato come gestito. Un altro scenario specifico per gli eventi di anteprima consiste nel contrassegnarli gestiti in modo che i gestori di classi bubbling corrispondenti non vengano richiamati.
