UIElement.OnTextInput(TextCompositionEventArgs) Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Se invoca cuando un evento adjunto TextInput sin controlar alcanza a un elemento derivado de esta clase en su ruta. Implemente este método a fin de agregar el control de clases para este evento.
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 -> unitProtected Overridable Sub OnTextInput (e As TextCompositionEventArgs)Parámetros
Objeto TextCompositionEventArgs que contiene los datos del evento.
Comentarios
Este método no tiene ninguna implementación predeterminada. Dado que una clase intermedia de la herencia podría implementar este método, se recomienda llamar a la implementación base en la implementación.
El propósito de este método es similar al patrón de eventos de Common Language Runtime (CLR) métodos On*: este método proporciona los medios para controlar el evento coincidente de las clases derivadas estableciendo un controlador de clases en lugar de un controlador de instancia. En este caso, el evento coincidente es un evento enrutado. El patrón de implementación de los métodos On* es diferente para los eventos enrutados porque un elemento secundario puede generar un evento enrutado, que no es necesariamente el elemento que invocará controladores. Por lo tanto, la implementación debe examinar las propiedades de origen de los datos del evento. No debe intentar recuperar el evento en la mayoría de los casos.
Mediante la invalidación de este método o mediante el registro de controladores de clases con RegisterClassHandler, las clases derivadas de pueden llamar a métodos de controlador de UIElement clases privadas cuando se recibe el evento a lo largo de la ruta del evento. Un escenario en el que el control de clases es adecuado es manipular los datos del evento y marcar el evento enrutado como controlado.
