UIElement.TextInput Evento

Definición

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.

Se aplica a