Ler em inglês

Compartilhar via


UIElement.TextInput Evento

Definição

Ocorre quando este elemento obtém texto de forma independente de dispositivo.

C#
public event System.Windows.Input.TextCompositionEventHandler TextInput;

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

Produto Versões
.NET Framework 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9