UIElement.PreviewTextInput UIElement.PreviewTextInput UIElement.PreviewTextInput UIElement.PreviewTextInput Event

定義

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

public:
 virtual event System::Windows::Input::TextCompositionEventHandler ^ PreviewTextInput;
public event System.Windows.Input.TextCompositionEventHandler PreviewTextInput;
member this.PreviewTextInput : System.Windows.Input.TextCompositionEventHandler 
Public Custom Event PreviewTextInput As TextCompositionEventHandler 

実装

注釈

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

キーの組み合わせ (既定のキーボードまたは入力方式のエディター) では、複数のキーイベントによってテキスト入力イベントが1つだけ発生する場合があります。Because of key combinations - either in default keyboards or through input method editors - multiple key events may raise just one text input event.

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

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

識別子フィールドIdentifier field PreviewTextInputEvent
ルーティング方法Routing strategy トンネリングTunneling
DelegateDelegate TextCompositionEventHandler
  • 対応するバブルイベントはTextInputです。The corresponding bubbling event is TextInput.

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

適用対象

こちらもご覧ください