UIElement.TextInput UIElement.TextInput UIElement.TextInput UIElement.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 。これにより、が基本要素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
DelegateDelegate TextCompositionEventHandler
  • 対応するトンネリングイベントはPreviewTextInputです。The corresponding tunneling event is PreviewTextInput.

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

適用対象