RoutedEventHandler RoutedEventHandler RoutedEventHandler RoutedEventHandler Delegate

定義

すべてのルーティング イベントに共通なデータ以外の特定のイベント データを持たない、さまざまなルーティング イベントを処理するメソッドを表します。Represents the method that will handle various routed events that do not have specific event data beyond the data that is common for all routed events.

public delegate void RoutedEventHandler(System::Object ^ sender, RoutedEventArgs ^ e);
public delegate void RoutedEventHandler(object sender, RoutedEventArgs e);
type RoutedEventHandler = delegate of obj * RoutedEventArgs -> unit
Public Delegate Sub RoutedEventHandler(sender As Object, e As RoutedEventArgs)

パラメーター

sender
Object Object Object Object

イベント ハンドラーがアタッチされているオブジェクト。The object where the event handler is attached.

e
RoutedEventArgs RoutedEventArgs RoutedEventArgs RoutedEventArgs

イベントのデータ。The event data.

継承
RoutedEventHandlerRoutedEventHandlerRoutedEventHandlerRoutedEventHandler

注釈

RoutedEventHandlerイベント データのイベントに固有の情報が報告はどのルーティング イベントのデリゲートを使用します。The RoutedEventHandler delegate is used for any routed event that does not report event-specific information in the event data. そのような多くのルーティング イベント; があります。著名な例としては、ClickLoadedします。There are many such routed events; prominent examples include Click and Loaded.

一般的なのではなくルーティング イベントのハンドラーの記述の最も特筆すべき違い共通言語ランタイム (CLR)common language runtime (CLR)イベントは、senderを必ずしもソースのイベント (ハンドラーがアタッチされ、呼び出される位置の要素) は見なされませんイベントです。The most noteworthy difference between writing a handler for a routed event as opposed to a general 共通言語ランタイム (CLR)common language runtime (CLR) event is that the sender of the event (the element where the handler is attached and invoked) cannot be considered to necessarily be the source of the event. ソースは、イベント データ内のプロパティとして報告されます (Source)。The source is reported as a property in the event data (Source). 違いsenderSource要素ツリーを通じてルーティング イベントの検査中に、異なる要素にルーティングされるイベントの結果です。A difference between sender and Source is the result of the event being routed to different elements, during the traversal of the routed event through an element tree.

いずれかを使用するsenderまたはSourceオブジェクトの参照を直接またはバブル ルーティング イベントのルーティングの動作に関心は意図的に処理する場合ルーティング イベント最初に発生が要素にします。You can use either sender or Source for an object reference if you are deliberately not interested in the routing behavior of a direct or bubbling routed event and you only intend to handle routed events on the elements where they are first raised. このような状況でsenderSource同じオブジェクトです。In this circumstance, sender and Source are the same object.

イベント ハンドラーを記述するときで動作するイベント データの 2 つの最も重要なプロパティは、ルーティング イベントの固有の機能を活用し、それに応じて、ハンドラーを作成する場合は、SourceHandledします。If you do intend to take advantage of the inherent features of routed events and write your handlers accordingly, the two most important properties of the event data that you will work with when writing event handlers are Source and Handled.

入力イベントの特定の組み合わせとWPFWPFコントロール クラスでは、イベントを発生させる要素がそれを処理する機会を持つ最初の要素ではありません。For certain combinations of input events and WPFWPF control classes, the element that raises the event is not the first element that has the opportunity to handle it. 最初のチャンスが入力イベントがある場合、イベントのプレビュー バージョンから要素ツリーのルートを設定できる、Handledtrue共有イベント データにし、そのイベント ルート上で残りの要素に入力イベントを報告する方法に影響を与えることができます。If the input event has a Preview version of the event, then the root of the element tree has first opportunity, can set Handled to true in the shared event data, and can influence how the input event is reported to remaining elements in its event route. 処理の動作は、特定のルーティング イベントがない外観を与えることができます、プレビューでは、期待どおりに発生します。The Preview handling behavior can give the appearance that a particular routed event is not raised as expected. 詳細については、次を参照してください。プレビュー イベント入力の概要します。For more information, see Preview Events and Input Overview.

Extension Methods

GetMethodInfo(Delegate) GetMethodInfo(Delegate) GetMethodInfo(Delegate) GetMethodInfo(Delegate)

指定したデリゲートによって表されるメソッドを表すオブジェクトを取得します。Gets an object that represents the method represented by the specified delegate.

適用対象