RoutedEventArgs.Source プロパティ

定義

イベントを発生させたオブジェクトへの参照を取得または設定します。Gets or sets a reference to the object that raised the event.

public:
 property System::Object ^ Source { System::Object ^ get(); void set(System::Object ^ value); };
public object Source { get; set; }
member this.Source : obj with get, set
Public Property Source As Object

プロパティ値

イベントを発生させたオブジェクト。The object that raised the event.

注釈

ルートを発生させた要素の後に実際に移動したすべてのバブルルーティングイベントに対して、まだトンネルダウンされていないすべてのトンネルルーティングイベントについて、Source の値はの値とは異なり senderイベント引数クラスのパラメーター。For any bubbling routed event that has actually traveled the route beyond the element that raised it, and for any tunneling routed event that has not yet tunneled down to the element that raised it, the value of Source will be different than the value of the sender parameter of the event arguments class. イベントに関係する2つの要素のうち、特定のハンドラー (Source、そのハンドラーを発生させた要素、または senderで最も重要な要素は、ハンドラーが処理しているアプリケーションロジックによって異なります。Which of the two elements involved in the event is of the most importance in any given handler (Source, the element that raised it, or sender, the element that is currently handling it) is dependent on the application logic that your handler is addressing.

このプロパティの設定は、通常、イベントソースを調整する他の Api をオーバーライドまたは実装する場合 (クラスがイベントを処理する場合など) にのみ実行されます。Setting this property is typically only done when overriding or implementing other APIs that adjust event sources, such as when class handling an event. 特にハンドラーがイベントを処理済みとしてマークしない場合、インスタンスハンドラーからの見かけ上のイベントソースのリセットは推奨されません。Resetting apparent event sources from instance handlers is not recommended, particularly when the handler does not mark the event as handled.

別のイベントソースをレポートするために Source をリセットすると、OriginalSource は元の RaiseEvent 呼び出しによって最初に発生したソースを報告し続けます。If you do reset Source to report a different event source, OriginalSource will continue to report the source as first raised by the originating RaiseEvent call.

適用対象

こちらもご覧ください