ContentElement.TextInput 事件

定义

命名空间:

System.Windows

程序集:

PresentationCore.dll

在此元素以设备无关模式获取文本时发生。

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 

事件类型

TextCompositionEventHandler

实现

TextInput

注解

重要

此事件可能已标记为由复合控件的内部实现处理。 请参阅下面的备注。

事件 TextInput 可能已标记为由复合控件的内部实现处理。 例如， 是 TextBox 一个复合控件， TextInput 其中事件已标记为已处理;在其合成中。 控件执行此操作是因为控件需要将某些类型的输入（如箭头键）解释为对该控件具有特殊含义。 如果使用 PreviewTextInput 作为附加文本输入处理程序的事件，可能会收到更好的结果。 此方法可避免控件组合已将此事件标记为已处理的大部分情况，并阻止处理程序沿事件路由接收事件。

事件 TextInput 允许组件或应用程序以与设备无关的方式侦听文本输入。 键盘是 的主要方法 TextInput，但语音、手写和其他输入设备也可以引发 TextInput。

由于组合键 （ 在默认键盘中或通过输入法编辑器） ，多个键事件可能只引发一个文本输入事件。

此事件为此类的TextCompositionManager.TextInput附加事件创建别名，以便在作为基元素继承时ContentElement，该TextInput事件是类成员列表的一部分。 附加到 TextInput 事件的事件处理程序将附加到基础 TextCompositionManager.TextInput 附加事件，并接收相同的事件数据实例。

路由事件信息

标识符字段	TextInputEvent
路由策略	鼓 泡
委托	TextCompositionEventHandler

• 相应的隧道事件为 PreviewTextInput。

• 重写 OnTextInput 以在派生类中实现此事件的类处理。