RoutedEventArgs.OriginalSource Propriedade
Definição
Importante
Algumas informações dizem respeito a um produto pré-lançado que pode ser substancialmente modificado antes de ser lançado. A Microsoft não faz garantias, de forma expressa ou implícita, em relação à informação aqui apresentada.
Obtém a fonte original de reporte determinada por testes puros de sucesso, antes de qualquer possível Source ajuste por parte de uma turma-mãe.
public:
property System::Object ^ OriginalSource { System::Object ^ get(); };
public object OriginalSource { get; }
member this.OriginalSource : obj
Public ReadOnly Property OriginalSource As Object
Valor de Propriedade
A fonte original de reporte, antes de qualquer possível Source ajuste feito pelo tratamento das classes, que possa ter sido feito para achatar árvores de elementos compostos.
Observações
Esta propriedade adquire o seu valor uma vez, antes de os gestores de eventos de classe ou qualquer gestor de instância serem invocados, e nunca é ajustada para além desse ponto. A informação de origem original é apenas de leitura para gestores de classes ou implementações de classes, tal como é reportada nos dados do evento.
Casos comuns em que a fonte pode ser ajustada incluem elementos de conteúdo dentro de um modelo de conteúdo para um controlo (o conteúdo de um item da lista, por exemplo, irá reportar o elemento do item da lista como o Source e o elemento real dentro do elemento da lista será o OriginalSource.
O ajuste da fonte por vários elementos e modelos de conteúdo varia de classe para classe. Cada classe que ajusta as fontes de eventos tenta antecipar qual a fonte mais útil para reportar para a maioria dos cenários de entrada e para os cenários para os quais a classe se destina, e depois define essa fonte como o Source. Se esta fonte não for a relevante para a tua gestão do evento, tenta verificar OriginalSource se reporta uma fonte diferente que seja mais adequada. Para mais detalhes sobre eventos de entrada, veja Visão Geral de Entrada.