Compartilhar via


UIElement.TextInput Evento

Definição

Ocorre quando este elemento obtém texto de forma independente de 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

Implementações

Comentários

Importante

Esse evento pode já estar marcado como manipulado pelas implementações internas de controles compostos. Consulte o Comentário abaixo.

O TextInput evento já pode estar marcado como manipulado pelas implementações internas de controles compostos. Por exemplo, um TextBox é um controle composto em que o TextInput evento já está marcado como manipulado; dentro de sua composição. Os controles fazem isso porque o controle precisa interpretar alguns tipos de entrada, como teclas de direção, como ter um significado especial para esse controle. Se você usar PreviewTextInput como o evento em que anexa manipuladores para entrada de texto, poderá receber melhores resultados. Essa técnica contorna a maioria dos casos em que a composição de controle já marcou esse evento como manipulado e impede que o manipulador receba o evento ao longo da rota do evento.

O TextInput evento permite que um componente ou aplicativo escute a entrada de texto de maneira independente do dispositivo. O teclado é o principal meio de TextInput, mas fala, manuscrito e outros dispositivos de entrada também podem gerar TextInput.

Devido a combinações de teclas , seja em teclados padrão ou por meio de editores de método de entrada - vários eventos de tecla podem gerar apenas um evento de entrada de texto.

Esse evento cria um alias para o TextCompositionManager.TextInput evento anexado para essa classe, de modo que TextInput faz parte da lista de membros da classe quando UIElement é herdado como um elemento base. Os manipuladores de eventos anexados ao TextInput evento são anexados ao evento anexado subjacente TextCompositionManager.TextInput e recebem a mesma instância de dados de evento.

Informações de evento encaminhado

Campo Identificador TextInputEvent
Estratégia de roteamento Borbulhando
Delegar TextCompositionEventHandler
  • O evento de túnel correspondente é PreviewTextInput.

  • Substitua OnTextInput para implementar o tratamento de classe para esse evento em classes derivadas.

Aplica-se a