UIElement.OnTextInput(TextCompositionEventArgs) 方法

定义

命名空间:

System.Windows

程序集:

PresentationCore.dll

当某个未处理的 TextInput 附加事件在其路由中到达派生自此类的某个元素时调用。 实现此方法可为此事件添加类处理。

C#

protected virtual void OnTextInput(System.Windows.Input.TextCompositionEventArgs e);

参数

e

TextCompositionEventArgs

包含事件数据的 TextCompositionEventArgs。

注解

此方法没有默认实现。 由于继承中的中间类可能实现此方法，因此建议在实现中调用基实现。

此方法的用途类似于公共语言运行时 (CLR) 事件模式 On* 方法：此方法提供通过建立类处理程序而不是实例处理程序来处理派生类中的匹配事件的方法。 在这种情况下，匹配事件是路由事件。 On* 方法的实现模式对于路由事件是不同的，因为路由事件可由子元素引发，子元素不一定是将调用处理程序的元素。 因此，实现需要检查事件数据的源属性。 在大多数情况下，它不应尝试重新触发事件。

通过重写此方法或使用 注册类处理程序 RegisterClassHandler，当沿事件路由收到事件时，的 UIElement 派生类可以调用私有类处理程序方法。 适合类处理的一种方案是操作事件数据并将路由事件标记为已处理。

适用于

另请参阅

• TextInput