UIElement.TextInput Evento
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 produce cuando este elemento obtiene texto de un modo independiente del dispositivo.
public:
virtual event System::Windows::Input::TextCompositionEventHandler ^ TextInput;
public event System.Windows.Input.TextCompositionEventHandler TextInput;
member this.TextInput : System.Windows.Input.TextCompositionEventHandler
Public Custom Event TextInput As TextCompositionEventHandler
Tipo de evento
Implementaciones
Comentarios
Importante
Es posible que este evento ya esté marcado como controlado por las implementaciones internas de controles compuestos. Vea la nota a continuación.
Es posible que el TextInput evento ya esté marcado como controlado por las implementaciones internas de controles compuestos. Por ejemplo, es TextBox un control compuesto donde el TextInput evento ya está marcado como controlado; dentro de su composición. Los controles lo hacen porque el control debe interpretar algunos tipos de entrada, como las teclas de dirección, como tener un significado especial para ese control. Si usa PreviewTextInput como evento donde adjunta controladores para la entrada de texto, puede recibir mejores resultados. Esta técnica evita la mayoría de los casos en los que la composición del control ya ha marcado este evento como controlado e impide que el controlador reciba el evento a lo largo de la ruta del evento.
El TextInput evento permite que un componente o una aplicación escuchen la entrada de texto de forma independiente del dispositivo. El teclado es el medio principal de TextInput, pero la voz, la escritura a mano y otros dispositivos de entrada también pueden generar TextInput.
Debido a las combinaciones de teclas, ya sea en teclados predeterminados o a través de editores de métodos de entrada, varios eventos de tecla pueden generar un solo evento de entrada de texto.
Este evento crea un alias para el TextCompositionManager.TextInput evento adjunto para esta clase, por lo que TextInput forma parte de la lista de miembros de clase cuando UIElement se hereda como un elemento base. Los controladores de eventos que están asociados al TextInput evento se adjuntan al evento adjunto subyacente TextCompositionManager.TextInput y reciben la misma instancia de datos de evento.
Información sobre eventos enrutados
Campo identificador | TextInputEvent |
Estrategia de enrutamiento | Burbujeante |
Delegado | TextCompositionEventHandler |
El evento de tunelización correspondiente es PreviewTextInput.
Invalide OnTextInput para implementar el control de clases para este evento en clases derivadas.