UIElement.TextInput Evento
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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.