ContentElement.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 、 が基本要素として継承されるときに ContentElement 、クラス メンバー リストの一部になります。 イベントに TextInput アタッチされたイベント ハンドラーは、基になる TextCompositionManager.TextInput アタッチされたイベントにアタッチされ、同じイベント データ インスタンスを受け取ります。

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

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

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

適用対象