UIElement.OnPreviewKeyDown(KeyEventArgs) メソッド

定義

アタッチされた未処理の PreviewKeyDown イベントが、そのルート上で、このクラスから派生した要素に到達すると呼び出されます。 このイベントに対するクラス処理を追加するには、このメソッドを実装します。

protected:
 virtual void OnPreviewKeyDown(System::Windows::Input::KeyEventArgs ^ e);
protected virtual void OnPreviewKeyDown (System.Windows.Input.KeyEventArgs e);
abstract member OnPreviewKeyDown : System.Windows.Input.KeyEventArgs -> unit
override this.OnPreviewKeyDown : System.Windows.Input.KeyEventArgs -> unit
Protected Overridable Sub OnPreviewKeyDown (e As KeyEventArgs)

パラメーター

e
KeyEventArgs

イベント データを格納している KeyEventArgs

注釈

このメソッドには既定の実装がありません。 継承の中間クラスはこのメソッドを実装する可能性があるため、実装で基本実装を呼び出すことをお勧めします。

このメソッドの目的は、* メソッドのイベントパターンに似てい 共通言語ランタイム (CLR)common language runtime (CLR) ます。このメソッドは、インスタンスハンドラーではなくクラスハンドラーを確立することによって、派生クラスから一致するイベントを処理する手段を提供します。 この場合、一致イベントはルーティングイベントです。 On * メソッドの実装パターンは、ルーティングイベントによって異なります。これは、ルーティングイベントは子要素によって発生する可能性があるためです。これは、必ずしもハンドラーを呼び出す要素ではありません。 そのため、実装では、イベントデータのソースプロパティを調べる必要があります。 ほとんどの場合、イベントを reraise しないようにしてください。

このメソッドをオーバーライドするか、を使用してクラスハンドラーを登録することにより RegisterClassHandler 、の派生クラスは、イベント UIElement がイベントルートに沿って受信されたときにプライベートクラスハンドラーメソッドを呼び出すことができます。 クラス処理が適切なシナリオの1つは、イベントデータを操作し、ルーティングイベントを処理済みとしてマークすることです。 プレビューイベント専用のもう1つのシナリオは、対応するバブルクラスハンドラーが呼び出されないように、それらを処理済みとしてマークすることです。

適用対象

こちらもご覧ください