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) イベント パターン On* メソッドに似ています。このメソッドは、インスタンス ハンドラーではなくクラス ハンドラーを確立することで、派生クラスから一致するイベントを処理する手段を提供します。 この場合、一致するイベントはルーティング イベントです。 ルーティング イベントは子要素によって発生する可能性があります。これは、ハンドラーを呼び出す要素とは限らないため、ルーティング イベントでは On* メソッドの実装パターンが異なります。 そのため、実装では、イベント データのソース プロパティを調べる必要があります。 ほとんどの場合、イベントの再レイズを試みる必要があります。

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

適用対象

こちらもご覧ください