ContentElement.OnPreviewTextInput(TextCompositionEventArgs) Método
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Invocado quando um evento anexo não tratado PreviewTextInput atinge um elemento na sua rota derivado desta classe. Implemente este método para adicionar o tratamento de classes para este evento.
protected public:
virtual void OnPreviewTextInput(System::Windows::Input::TextCompositionEventArgs ^ e);protected internal virtual void OnPreviewTextInput(System.Windows.Input.TextCompositionEventArgs e);abstract member OnPreviewTextInput : System.Windows.Input.TextCompositionEventArgs -> unit
override this.OnPreviewTextInput : System.Windows.Input.TextCompositionEventArgs -> unitProtected Friend Overridable Sub OnPreviewTextInput (e As TextCompositionEventArgs)Parâmetros
O TextCompositionEventArgs que contém os dados do evento.
Observações
Este método não tem implementação por defeito. Como uma classe intermédia na herança pode implementar este método, recomendamos que chame a implementação base na sua implementação.
O objetivo deste método é semelhante ao padrão de eventos On* em tempo de execução da linguagem comum (CLR): este método fornece os meios para lidar com o evento correspondente de classes derivadas, estabelecendo um gestor de classes em vez de um gestor de instâncias. Neste caso, o evento de correspondência é um evento encaminhado. O padrão de implementação dos métodos On* é diferente para eventos encaminhados porque um evento encaminhado pode ser gerado por um elemento filho, que não é necessariamente o elemento que irá invocar os handlers. Por isso, a sua implementação precisa de examinar as propriedades de origem dos dados do evento. Na maioria dos casos, não deve tentar reabrir o evento.
Quer sobrescrevendo este método, quer registando manipuladores de classe com RegisterClassHandler, classes derivadas de ContentElement podem chamar métodos de gestores privados de classes quando o evento é recebido ao longo da rota do evento. Um cenário em que o tratamento de classes é apropriado é manipular os dados do evento e marcar o evento encaminhado como tratado. Outro cenário específico para eventos de Pré-visualização é marcá-los como tratados para que os gestores de classe bubbling correspondentes não sejam invocados.