RoutedEventArgs.Source Propriedade

Definição

Obtém ou define uma referência ao objeto que ativou o evento.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

Valor da propriedade

O objeto que gerencie o evento.The object that raised the event.

Comentários

Para qualquer propagação de evento que realmente percorreu a rota após o elemento que o gerou roteado e para qualquer túnel evento não foi roteado ainda encapsulado para baixo até o elemento que o gerou, o valor de Source será diferente do valor da sender parâmetro de classe de argumentos de evento.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. Quais dos dois elementos envolvidos no evento é a maior importância em qualquer manipulador específico (Source, o elemento que o gerou, ou sender, o elemento que está manipulando atualmente) depende da lógica do aplicativo que o seu manipulador está resolvendo.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.

A definição dessa propriedade normalmente é feita apenas ao substituir ou implementar outras APIs que ajustam fontes de eventos, como quando a classe manipula um evento.Setting this property is typically only done when overriding or implementing other APIs that adjust event sources, such as when class handling an event. A redefinição de fontes de eventos aparentes de manipuladores de instância não é recomendada, especialmente quando o manipulador não marca o evento como manipulado.Resetting apparent event sources from instance handlers is not recommended, particularly when the handler does not mark the event as handled.

Se você redefinir Source para relatar uma origem de evento diferente, OriginalSource continuará a relatar a origem como gerada pela primeira vez pela chamada de RaiseEvent de origem.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.

Aplica-se a

Veja também