エクスポート (0) 印刷
すべて展開
情報
要求されたトピックは次のとおりです。しかし、このトピックはこのライブラリには含まれていません。

UIElement.TextInput イベント

2013/12/12

デバイスに依存しない方法で UI 要素がテキストを取得すると発生します。

Namespace:  System.Windows
アセンブリ:  System.Windows (System.Windows.dll 内)
XAML の XMLNS: xmlns にマップされていません。

public event TextCompositionEventHandler TextInput
<uiElement TextInput="eventhandler"/>

このイベントは非同期で発生します。

TextCompositionEventHandler に基づくハンドラーを使用して、このイベントを処理します。

TextInput は、通常、KeyUp または KeyDown を使用して結果を統合し、既にキーごとにキー入力を処理している要素 (TextBox など) で発生します。TextInput は、TextBox に固有ではなく、UIElement に一般的なイベントです。これは、通知するルーティング イベントであり、したがって、複合コンテナーによって処理できる可能性があるイベントであるためです。たとえば、カスタム コントロールでは、テキスト ボックス コンポーネントの 1 つ以上を更新することが注目され、コンポーネント ルート レベルの TextInput が、OnApplyTemplate 実装での操作の 1 つとしてフックされる場合があります。

TextInput イベントは、デバイスに依存しない方法でコンポーネントまたはアプリケーションがテキスト入力をリッスンできるようにします。テキスト入力の主な方法はキーボードですが、カスタム タッチ ジェスチャや、入力エディター (IME) などのその他の入力方法によって TextInput が発生する可能性もあります。

このイベントはバブル イベントです。これは、オブジェクト ツリーの親子関係によって関連付けられたオブジェクトのシーケンス用に複数の TextInput ハンドラーが登録されている場合、その親子関係の各オブジェクトによって、親の方向にルーティングされてイベントが受け取られることを意味します。イベント ハンドラーに使用できる sender は、イベントが処理されるオブジェクトを識別します。そのオブジェクトは、イベントを開始する入力条件を実際に受け取ったオブジェクトであるとは限りません。イベントを開始したオブジェクトを見つけるには、イベントの RoutedEventArgs イベント データの OriginalSource 値を使用します。ルーティング イベントの概念の詳細については、「Windows Phone のイベント」を参照してください。

Windows Phone での IME サポートには、IME の処理と動作に影響を与えることのできる添付プロパティが含まれており、これは、TextBox で設定できます。InputMethod を参照してください。

TextInput と OnTextInput

コントロール クラス (Control から派生するすべてのクラス) には、OnTextInput で定義されているように、テキスト入力に割り当てられている仮想/上書きイベント ハンドラーがある可能性があります。

Windows Phone OS

サポート: 8.0, 7.1

表示:
© 2015 Microsoft