ContentElement.TextInput ContentElement.TextInput ContentElement.TextInput ContentElement.TextInput Event

定義

この要素がデバイスに依存しない方法でテキストを取得したときに発生します。Occurs when this element gets text in a device-independent manner.

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 

実装

注釈

重要

このイベントは、複合コントロールの内部実装によって処理済みとして既にマーク可能性があります。This event might already be marked as handled by the internal implementations of composited controls. 以下の解説を参照してください。See Remark below.

TextInputイベントは、複合コントロールの内部実装によって処理済みとして既にマーク可能性があります。The TextInput event may already be marked as handled by the internal implementations of composited controls. たとえば、TextBox複合コントロールは、場所、TextInputイベントが処理済みとしては、合成内に既にマークされています。For example, a TextBox is a composited control where the TextInput event is already marked as handled; within its compositing. コントロールでは、コントロールがいくつかの種類のコントロールに特別な意味を持つものとして、方向キーなどの入力を解釈する必要があるため、このようにします。Controls do this because the control needs to interpret some types of input, such as arrow keys, as having special meaning to that control. 使用する場合PreviewTextInput、テキスト入力用のハンドラーをアタッチするイベントとしてより良い結果が表示される可能性があります。If you use PreviewTextInput as the event where you attach handlers for text input, you may receive better results. この手法では、ほとんどの場合コントロール合成が処理済みとしてこのイベントが既にマークし、ハンドラーがイベント ルート上のイベントを受信するを防ぎますを回避できます。This technique circumvents most cases where control composition has already marked this event as handled and prevents your handler from receiving the event along the event route.

TextInputイベントでは、コンポーネントまたはデバイスに依存しない方法でテキスト入力をリッスンするアプリケーション。The TextInput event allows a component or application to listen for text input in a device-independent manner. キーボードの主要な手段は、 TextInput、音声認識、手書き入力、およびその他の入力デバイスにもに上げることができますが、TextInputします。The keyboard is the primary means of TextInput, but speech, handwriting, and other input devices can also raise TextInput.

-既定のキーボードまたは入力方式エディター - 経由のいずれかのキーの組み合わせにより、複数のキー イベントは 1 つのテキスト入力イベントを発生可能性があります。Because of key combinations - either in default keyboards or through input method editors - multiple key events might raise just one text input event.

このイベントのエイリアスを作成する、TextCompositionManager.TextInput添付イベントは、このクラスのようにTextInput一部であるクラスのメンバーのリストContentElementは基本要素として継承されます。This event creates an alias for the TextCompositionManager.TextInput attached event for this class, so that TextInput is part of the class members list when ContentElement is inherited as a base element. イベント ハンドラーに関連付けられている、TextInputイベントは、基になるに関連付けられているTextCompositionManager.TextInput添付イベントと同じイベント データ インスタンスを受信します。Event handlers that are attached to the TextInput event are attached to the underlying TextCompositionManager.TextInput attached event and receive the same event data instance.

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

識別子フィールドです。Identifier field TextInputEvent
ルーティング方法Routing strategy バブルBubbling
DelegateDelegate TextCompositionEventHandler
  • 対応するトンネル イベントはPreviewTextInputします。The corresponding tunneling event is PreviewTextInput.

  • オーバーライドOnTextInput派生クラスでは、このイベントに対するクラス処理を実装します。Override OnTextInput to implement class handling for this event in derived classes.

適用対象