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アタッチされたイベントにアタッチされ、同じイベント データ インスタンスを受け取ります。

ルーティング イベント情報

• 対応するトンネリング イベントが PreviewTextInput。

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