UIElement.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 イベントの種類
実装
注釈
重要
このイベントは、複合コントロールの内部実装によって既に処理済みとしてマークされている可能性があります。 以下の解説を参照してください。
このイベントは TextInput 、複合コントロールの内部実装によって既に処理済みとしてマークされている可能性があります。 たとえば、a TextBox は複合コントロールであり、イベントは既に TextInput 処理済みとしてマークされています。その合成内です。 コントロールは、方向キーなどの一部の種類の入力を、そのコントロールに対して特別な意味を持つものとして解釈する必要があるため、これを行います。 テキスト入力のハンドラーをアタッチするイベントとして使用 PreviewTextInput すると、より良い結果が得られます。 この手法は、コントロールコンポジションがこのイベントを既に処理済みとしてマークしており、ハンドラーがイベント ルートに沿ってイベントを受信できないようにするほとんどの場合を回避します。
この TextInput イベントにより、コンポーネントまたはアプリケーションは、デバイスに依存しない方法でテキスト入力をリッスンできます。 キーボードは主な手段 TextInputですが、音声、手書き、その他の入力デバイスでも発生 TextInputさせることができます。
既定のキーボードまたは入力メソッド エディターを使用したキーの組み合わせにより、複数のキー イベントによって 1 つのテキスト入力イベントが発生する可能性があります。
このイベントは、基本要素として継承されるときにUIElementクラス メンバー リストの一部になるようにTextInput、このクラスの添付イベントのエイリアスTextCompositionManager.TextInputを作成します。 イベントに TextInput アタッチされたイベント ハンドラーは、基になる TextCompositionManager.TextInput 添付イベントにアタッチされ、同じイベント データ インスタンスを受信します。
ルーティングされたイベント情報
| 識別子フィールド | TextInputEvent |
| ルーティング戦略 | バブル |
| 代理人 | TextCompositionEventHandler |
対応するトンネリング イベントは PreviewTextInput.
派生クラスでこのイベントのクラス処理を実装するオーバーライド OnTextInput 。