Compartilhar via


RoutedEventArgs.OriginalSource Propriedade

Definição

Obtém a origem de relatório original conforme determinada pelo teste de clique puro, antes de qualquer ajuste possível da Source por parte de uma classe pai.

public:
 property System::Object ^ OriginalSource { System::Object ^ get(); };
public object OriginalSource { get; }
member this.OriginalSource : obj
Public ReadOnly Property OriginalSource As Object

Valor da propriedade

Object

A origem de relatório original, antes de qualquer ajuste Source possível realizado pelo tratamento de classe, que pode ter sido feito para mesclar árvores de elementos compostos.

Comentários

Essa propriedade adquire seu valor uma vez, antes que os manipuladores de eventos de classe ou quaisquer manipuladores de instância sejam invocados e nunca seja ajustada após esse ponto. As informações de origem originais são somente leitura para manipuladores de classe ou implementações de classe, assim como são relatadas nos dados do evento.

Casos comuns em que a origem pode ser ajustada incluem elementos de conteúdo dentro de um modelo de conteúdo para um controle (o conteúdo de um item de lista, por exemplo, relatará o elemento de item de lista como o Source elemento e o elemento real dentro do item de lista será o OriginalSource.

O ajuste de origem por vários elementos e modelos de conteúdo varia de classe para classe. Cada classe que ajusta fontes de evento tenta prever qual origem é a mais útil para relatar para a maioria dos cenários de entrada e os cenários para os quais a classe se destina e, em seguida, define essa origem como a Source. Se essa origem não for a que tem relevância para o tratamento do evento, tente verificar OriginalSource se ele relata uma fonte diferente que seja mais adequada. Para obter mais detalhes sobre eventos de entrada, consulte a Visão Geral de Entrada.

Aplica-se a

Confira também