UIElement.TextInput イベント
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
この要素がデバイスに依存しない方法でテキストを取得したときに発生します。
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 、 が基本要素として継承されると、クラス メンバー リスト UIElement の一部になります。 イベントに TextInput アタッチされたイベント ハンドラーは、基になる TextCompositionManager.TextInput アタッチされたイベントにアタッチされ、同じイベント データ インスタンスを受け取ります。
ルーティングされたイベント情報
| 識別子フィールド | TextInputEvent |
| ルーティング戦略 | バブル |
| 代理人 | TextCompositionEventHandler |
対応するトンネリング イベントは です PreviewTextInput。
派生クラスでこのイベントのクラス処理を実装するには、 をオーバーライド OnTextInput します。
適用対象
.NET