UIElement.TextInput イベント

定義

この要素がデバイスに依存しない方法でテキストを取得したときに発生します。

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 、複合コントロールの内部実装によって既に処理済みとしてマークされている可能性があります。 たとえば、 は複合コントロールであり、 TextBox イベントは既に TextInput 処理済みとしてマークされており、その合成内にあります。 コントロールは、方向キーなどの一部の種類の入力を、そのコントロールに対して特別な意味を持つものとして解釈する必要があるため、これを行います。 テキスト入力のハンドラーをアタッチするイベントとして を使用 PreviewTextInput すると、より良い結果が得られます。 この手法は、コントロールコンポジションによって既にこのイベントが処理済みとしてマークされ、ハンドラーがイベント ルートに沿ってイベントを受信できないようにしているほとんどの場合を回避します。

イベント TextInput を使用すると、コンポーネントまたはアプリケーションは、デバイスに依存しない方法でテキスト入力をリッスンできます。 キーボードは の主な手段 TextInputですが、音声、手書き、その他の入力デバイスでも を発生させることができます TextInput

既定のキーボードまたは入力メソッド エディターのキーの組み合わせにより、複数のキー イベントによってテキスト入力イベントが 1 つだけ発生する可能性があります。

このイベントは、このクラスの TextCompositionManager.TextInput 添付イベントのエイリアスを作成します。そのため TextInput 、 が基本要素として継承されると、クラス メンバー リスト UIElement の一部になります。 イベントに TextInput アタッチされたイベント ハンドラーは、基になる TextCompositionManager.TextInput アタッチされたイベントにアタッチされ、同じイベント データ インスタンスを受け取ります。

ルーティングされたイベント情報

識別子フィールド TextInputEvent
ルーティング戦略 バブル
代理人 TextCompositionEventHandler
  • 対応するトンネリング イベントは です PreviewTextInput

  • 派生クラスでこのイベントのクラス処理を実装するには、 をオーバーライド OnTextInput します。

適用対象