UIElement.TextInput イベント


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

 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 UIElement が基本要素として継承されている場合、はクラスメンバーリストの一部になります。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 UIElement 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
代理人Delegate TextCompositionEventHandler
  • 対応するトンネリングイベントは PreviewTextInput です。The corresponding tunneling event is PreviewTextInput.

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