UIElement3D.AddHandler メソッド

public:
 virtual void AddHandler(System::Windows::RoutedEvent ^ routedEvent, Delegate ^ handler);

public void AddHandler (System.Windows.RoutedEvent routedEvent, Delegate handler);

abstract member AddHandler : System.Windows.RoutedEvent * Delegate -> unit
override this.AddHandler : System.Windows.RoutedEvent * Delegate -> unit

Public Sub AddHandler (routedEvent As RoutedEvent, handler As Delegate)

パラメーター

実装

注釈

例外を発生させずに、同じイベントに対して同じハンドラーを複数回追加できます。 ただし、イベントが処理されると、ハンドラーは実際には複数回呼び出されます。 したがって、ハンドラーの実装でこの動作に考慮すべき副作用がある可能性がある方法を検討してください。

通常、このメソッドを使用して、カスタム ルーティング イベントの Microsoft .NET イベント アクセス パターンの "追加" アクセサーの実装を提供します。

public:
 void AddHandler(System::Windows::RoutedEvent ^ routedEvent, Delegate ^ handler, bool handledEventsToo);

public void AddHandler (System.Windows.RoutedEvent routedEvent, Delegate handler, bool handledEventsToo);

member this.AddHandler : System.Windows.RoutedEvent * Delegate * bool -> unit

Public Sub AddHandler (routedEvent As RoutedEvent, handler As Delegate, handledEventsToo As Boolean)

パラメーター

注釈

低レベルの入力イベントを実用的な方法で処理することは、複雑な作業です。 多くのコントロールは、特定のイベントが処理済みとしてマークされ、別のより直感的なイベントに置き換えられる動作を実装します。 一般に、コントロールでは、プラットフォーム入力イベントが処理済みとしてマークされるのは、これを行うための設計上の意図がある場合のみです。 特定のシナリオでは、これらの設計上の意図が、入力イベントの特定の処理に必要なものではありません。 これらのシナリオでは、適切なハンドラーtrueを にhandledEventsToo登録します。 しかし、これを日常的に行うべきではありません。 処理された場合でも、すべてのイベントに応答してハンドラーを呼び出すと、独自のアプリケーション イベント処理ロジックが複雑になります。 ハンドラー ロジックが大きい場合は、パフォーマンスが低下する可能性があります。 特定のコントロールがアプリケーション ロジックで処理するイベントを処理している開発プロセス中に既に検出された状況では、既に処理済みのイベントにハンドラーをアタッチする使用を予約する必要があります。

特定のイベントコントロールの組み合わせのクラス処理動作を回避するためのもう 1 つの手法は、そのイベントのプレビューの代替手段を使用することです。 たとえば、 がクラス処理によって処理済みとしてマークされている場合 MouseLeftButtonDown は、 のハンドラーを PreviewMouseLeftButtonDown 代わりに追加できます。

例外を発生させずに、同じイベントに対して同じハンドラーを複数回追加できます。 ただし、イベントが処理されると、ハンドラーは実際には複数回呼び出されます。 したがって、ハンドラーの実装でこの動作に考慮すべき副作用がある可能性がある方法を検討してください。

通常、このメソッドを使用して、カスタム ルーティング イベントの Microsoft .NET イベント アクセス パターンの "追加" アクセサーの実装を提供します。