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つのSourceプロパティHandledはとです。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.

拡張メソッド

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

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

適用対象