ContentElement.OnPreviewStylusDown(StylusDownEventArgs) ContentElement.OnPreviewStylusDown(StylusDownEventArgs) ContentElement.OnPreviewStylusDown(StylusDownEventArgs) ContentElement.OnPreviewStylusDown(StylusDownEventArgs) Method

定義

未処理の PreviewStylusDown 添付イベントが、そのルート上で、このクラスから派生した要素に到達すると呼び出されます。Invoked when an unhandled PreviewStylusDown attached event reaches an element in its route that is derived from this class. このイベントに対するクラス処理を追加するには、このメソッドを実装します。Implement this method to add class handling for this event.

protected public:
 virtual void OnPreviewStylusDown(System::Windows::Input::StylusDownEventArgs ^ e);
protected internal virtual void OnPreviewStylusDown (System.Windows.Input.StylusDownEventArgs e);
abstract member OnPreviewStylusDown : System.Windows.Input.StylusDownEventArgs -> unit
override this.OnPreviewStylusDown : System.Windows.Input.StylusDownEventArgs -> unit
Protected Friend Overridable Sub OnPreviewStylusDown (e As StylusDownEventArgs)

パラメーター

e
StylusDownEventArgs StylusDownEventArgs StylusDownEventArgs StylusDownEventArgs

イベント データを格納している StylusDownEventArgsThe StylusDownEventArgs that contains the event data.

注釈

このメソッドには既定の実装がありません。This method has no default implementation. 継承の中間クラスはこのメソッドを実装する可能性があるため、実装で基本実装を呼び出すことをお勧めします。Because an intermediate class in the inheritance might implement this method, we recommend that you call the base implementation in your implementation.

このメソッドの目的は、 共通言語ランタイム (CLR)common language runtime (CLR) *メソッドのイベントパターンに似ています。このメソッドは、インスタンスハンドラーではなくクラスハンドラーを確立することによって、派生クラスから一致するイベントを処理する手段を提供します。The purpose of this method is similar to the 共通言語ランタイム (CLR)common language runtime (CLR) event pattern On* methods: this method provides the means to handle the matching event from derived classes by establishing a class handler instead of an instance handler. この場合、一致イベントはルーティングイベントです。In this case the matching event is a routed event. ルーティングイベントは、必ずしも*ハンドラーを呼び出す要素ではない子要素によって発生する可能性があるため、On メソッドの実装パターンはルーティングイベントによって異なります。The implementation pattern of the On* methods is different for routed events because a routed event can be raised by a child element, which is not necessarily the element that will invoke handlers. そのため、実装では、イベントデータのソースプロパティを調べる必要があります。Therefore, your implementation needs to examine the source properties of the event data. ほとんどの場合、イベントを reraise しないようにしてください。It should not try to reraise the event in most cases.

このメソッドをオーバーライドするか、を使用RegisterClassHandlerしてクラスハンドラーを登録することにより、のContentElement派生クラスは、イベントがイベントルートに沿って受信されたときにプライベートクラスハンドラーメソッドを呼び出すことができます。Either by overriding this method or by registering class handlers with RegisterClassHandler, derived classes of ContentElement can call private class handler methods when the event is received along the event route. クラス処理が適切なシナリオの1つは、イベントデータを操作し、ルーティングイベントを処理済みとしてマークすることです。One scenario where class handling is appropriate is to manipulate the event data and mark the routed event as handled. プレビューイベント専用のもう1つのシナリオは、対応するバブルクラスハンドラーが呼び出されないように、それらを処理済みとしてマークすることです。Another scenario that is specifically for Preview events is to mark them handled so that the matching bubbling class handlers are not invoked.

適用対象

こちらもご覧ください