ContentElement.TextInput ContentElement.TextInput ContentElement.TextInput ContentElement.TextInput Event

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

Este evento ya podría marcarse como controlados por las implementaciones internas de controles compuestos.This event might already be marked as handled by the internal implementations of composited controls. Vea Comentarios más adelante.See Remark below.

El TextInput evento ya podría estar marcado como controlado por las implementaciones internas de 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 donde el TextInput evento 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. Controles hacen porque el control debe interpretar algunos tipos de entrada, como teclas de dirección, como si tuviera 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 donde adjuntar controladores para la entrada de texto, puede obtener 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 donde la composición de control ya ha marcado este evento como controlado y evita que el controlador de recepción del 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 TextInput evento permite que un componente o aplicación para realizar escuchas de entrada de texto de una manera 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 también pueden generar voz, escritura a mano y otros dispositivos de entrada TextInput.The keyboard is the primary means of TextInput, but speech, handwriting, and other input devices can also raise TextInput.

Debido a combinaciones de teclas - en los teclados predeterminados o a través de los editores de métodos de entrada - varios eventos de tecla podrían generar un solo evento de entrada de texto.Because 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 TextCompositionManager.TextInput adjunta eventos para esta clase, por lo que TextInput forma parte lista los miembros de la clase cuando ContentElement se hereda como 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. Controladores de eventos que están asociados a la TextInput se adjuntan eventos subyacente TextCompositionManager.TextInput evento adjunto 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.

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

Se aplica a