RoutedEventArgs.Source Właściwość

Definicja

Pobiera lub ustawia odwołanie do obiektu, który wywołał zdarzenie.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

Wartość właściwości

Object

Obiekt, który wywołał zdarzenie.The object that raised the event.

Uwagi

W przypadku wszystkich zdarzeń propagacji routingu, które faktycznie przekierowały trasy wykraczające poza element, który go wywołał, i dla dowolnego zdarzenia tunelowania, które nie zostało jeszcze przekierowane do elementu, który go spowodował, wartość Source będzie różna od wartości parametru sender klasy argumenty zdarzenia.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. Który z dwóch elementów uwzględnionych w zdarzeniu jest najbardziej istotny w przypadku każdej procedury obsługi (Source, element, który go spowodował, lub sender, element, który jest obecnie obsługiwany), zależy od logiki aplikacji, do której program obsługi ma adres.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.

Ustawienie tej właściwości jest zazwyczaj wykonywane tylko przy zastępowaniu lub zaimplementowaniu innych interfejsów API, które dostosowują źródła zdarzeń, na przykład gdy klasa obsługuje zdarzenie.Setting this property is typically only done when overriding or implementing other APIs that adjust event sources, such as when class handling an event. Nie zaleca się resetowania pozornych źródeł zdarzeń z procedur obsługi wystąpień, szczególnie w przypadku, gdy program obsługi nie oznaczy zdarzenia jako obsługiwanego.Resetting apparent event sources from instance handlers is not recommended, particularly when the handler does not mark the event as handled.

Jeśli zresetujesz Source, aby zgłosić inne źródło zdarzeń, OriginalSource będzie nadal zgłaszać źródło jako pierwsze podniesione przez wywołane wywołanie 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.

Dotyczy

Zobacz też