ContentElement.TextInput 事件
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
當這個元素以與裝置無關的方式接收文字時,就會發生。
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
事件類型
實作
備註
Important
此事件可能已被內部複合控制實作標記為已處理。 詳見下方備註。
TextInput事件可能已被內部複合控制實作標記為已處理。 例如,a TextBox 是一個複合控制,事件 TextInput 已標記為已處理;在合成過程中。 控制項之所以這麼做,是因為控制鍵需要將某些類型的輸入(如方向鍵)解讀為該控制具有特殊意義。 如果你用 PreviewTextInput 事件來附加處理程式來輸入文字,可能會得到更好的結果。 此技術可避開大多數控制組合已標記該事件為已處理的情況,並防止你的操作者在事件路徑上接收該事件。
此 TextInput 事件允許元件或應用程式以裝置無關的方式監聽文字輸入。 鍵盤是主要的 , TextInput但語音、書寫及其他輸入裝置也能提升 TextInput。
由於按鍵組合——無論是在預設鍵盤還是透過輸入法編輯器——多個按鍵事件可能會引發一個文字輸入事件。
此事件會為該類別附加事件建立別名TextCompositionManager.TextInput,因此當 TextInput 作為基礎元素繼承時,該ContentElement事件會成為類別成員清單的一部分。 附加 TextInput 於事件的事件處理器會附加到底層 TextCompositionManager.TextInput 附加事件,並接收相同的事件資料實例。
路由事件資訊
| Item | 價值觀 |
|---|---|
| 識別碼欄位 | TextInputEvent |
| 路由策略 | 氣泡 |
| 代理人 | TextCompositionEventHandler |
對應的隧道事件為 PreviewTextInput。
覆寫 OnTextInput 以實作衍生類別中此事件的類別處理。