ContentElement.TextInput Evento

Definición

Se produce cuando este elemento obtiene texto de un modo independiente del dispositivo.Occurs when this element gets text in a device-independent manner.

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 

Implementaciones

Comentarios

Importante

Es posible que este evento ya esté marcado como controlado por las implementaciones internas de los controles compuestos.This event might already be marked as handled by the internal implementations of composited controls. Consulte el siguiente comentario.See Remark below.

Es posible que el evento TextInput ya esté marcado como controlado por las implementaciones internas de los controles compuestos.The TextInput event may already be marked as handled by the internal implementations of composited controls. Por ejemplo, un TextBox es un control compuesto en el que el evento de TextInput ya está marcado como controlado; dentro de su composición.For example, a TextBox is a composited control where the TextInput event is already marked as handled; within its compositing. Los controles hacen esto porque el control debe interpretar algunos tipos de entrada, como las teclas de dirección, con un significado especial para ese control.Controls do this because the control needs to interpret some types of input, such as arrow keys, as having special meaning to that control. Si usa PreviewTextInput como el evento en el que se adjuntan Controladores para la entrada de texto, puede recibir mejores resultados.If you use PreviewTextInput as the event where you attach handlers for text input, you may receive better results. 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 y evita que el controlador reciba el evento a lo largo de la ruta del evento.This technique circumvents most cases where control composition has already marked this event as handled and prevents your handler from receiving the event along the event route.

El evento TextInput permite que un componente o una aplicación escuchen la entrada de texto de forma independiente del dispositivo.The TextInput event allows a component or application to listen for text input in a device-independent manner. 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.The keyboard is the primary means of TextInput, but speech, handwriting, and other input devices can also raise TextInput.

Debido a las combinaciones de teclas, ya sea en los teclados predeterminados o a través de los editores de métodos de entrada, es posible que varios eventos de clave produzcan un solo evento de entrada de textoBecause of key combinations - either in default keyboards or through input method editors - multiple key events might raise just one text input event.

Este evento crea un alias para el evento adjunto de TextCompositionManager.TextInput para esta clase, de modo que TextInput forme parte de la lista de miembros de clase cuando ContentElement se herede como un elemento base.This event creates an alias for the TextCompositionManager.TextInput attached event for this class, so that TextInput is part of the class members list when ContentElement is inherited as a base element. Los controladores de eventos adjuntos al evento TextInput se adjuntan al evento adjunto TextCompositionManager.TextInput subyacente y reciben la misma instancia de datos de evento.Event handlers that are attached to the TextInput event are attached to the underlying TextCompositionManager.TextInput attached event and receive the same event data instance.

Información sobre eventos enrutadosRouted Event Information

Campo de identificadorIdentifier field TextInputEvent
Estrategia de enrutamientoRouting strategy PropagaciónBubbling
delegadoDelegate TextCompositionEventHandler
  • El evento de tunelización correspondiente es PreviewTextInput.The corresponding tunneling event is PreviewTextInput.

  • Invalide OnTextInput para implementar el control de clases para este evento en las clases derivadas.Override OnTextInput to implement class handling for this event in derived classes.

Se aplica a