次の方法で共有


ContentElement.RemoveHandler(RoutedEvent, Delegate) メソッド

定義

指定したルーティング イベント ハンドラーをこの要素から削除します。

public:
 virtual void RemoveHandler(System::Windows::RoutedEvent ^ routedEvent, Delegate ^ handler);
public void RemoveHandler (System.Windows.RoutedEvent routedEvent, Delegate handler);
abstract member RemoveHandler : System.Windows.RoutedEvent * Delegate -> unit
override this.RemoveHandler : System.Windows.RoutedEvent * Delegate -> unit
Public Sub RemoveHandler (routedEvent As RoutedEvent, handler As Delegate)

パラメーター

routedEvent
RoutedEvent

ハンドラーがアタッチされているルーティング イベントの識別子。

handler
Delegate

この要素のイベント ハンドラー コレクションから削除する特定のハンドラー実装。

実装

注釈

この API を使用する最も一般的なシナリオは、カスタム ルーティング イベントに関連付けられている共通言語ランタイム (CLR) の "ラッパー" イベントを実装する場合です。特に、CLR レベルでハンドラーの "削除" ロジックを実装する場合です。 この解説セクションに続く例では、このシナリオを示します。

このメソッドの呼び出しは、メソッド呼び出しの入力パラメーターに一致する条件に登録されたハンドラーがない場合は影響しません。

条件に一致する複数のハンドラーがアタッチされている場合、イベント ハンドラー ストア内の最初のハンドラーのみが削除されます。 この動作は、演算子の -= CLR 動作と一致します。

どちら routedEvent でもない handler 場合もあります null。 いずれかの値 null を指定しようとすると、例外が発生します。

このメソッドは、既に処理されたイベントの handledEventsToo 処理を可能にするシグネチャを使用してハンドラーが最初に AddHandler(RoutedEvent, Delegate, Boolean) 追加された場合に提供されるパラメーター情報を無視します。 いずれかの種類のハンドラーが削除されます。

適用対象

こちらもご覧ください