UIElement.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 類別建立附加事件的別名，以便在 TextInput 繼承為基底專案時 UIElement ，屬於類別成員清單的一部分。 附加至 TextInput 事件的事件處理常式會附加至基礎 TextCompositionManager.TextInput 附加事件，並接收相同的事件資料實例。

路由事件資訊

識別碼欄位	TextInputEvent
路由策略	鼓 泡
代理人	TextCompositionEventHandler

• 對應的通道事件為 PreviewTextInput 。

• 覆寫 OnTextInput 以在衍生類別中實作這個事件的類別處理。