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.Gets the original reporting source as determined by pure hit testing, before any possible Source adjustment by a parent class.

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

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.The original reporting source, before any possible Source adjustment made by class handling, which may have been done to flatten composited element trees.

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 são ajustados após esse ponto.This property acquires its value once, before the class event handlers or any instance handlers are invoked, and is never adjusted past this point. 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 de evento.The original source information is read-only to class handlers or class implementations, just as it is reported in the event data.

Os 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 item de lista como o Source e o elemento real dentro do item de lista será o OriginalSource.Common cases where the source may be adjusted include content elements inside a content model for a control (the contents of a list item, for instance, will report the list item element as the Source and the actual element within the list item will be the OriginalSource.

O ajuste de origem por vários elementos e modelos de conteúdo varia de classe para classe.Source adjustment by various elements and content models varies from class to class. Cada classe que ajusta as origens do evento tenta prever qual fonte é a mais útil para relatar a maioria dos cenários de entrada e os cenários para os quais a classe é pretendida e, em seguida, define essa fonte como a Source.Each class that adjusts event sources attempts to anticipate which source is the most useful to report for most input scenarios and the scenarios for which the class is intended, and then sets that source as the Source. Se essa fonte não for aquela que tem relevância para sua manipulação do evento, tente verificar OriginalSource em vez disso para ver se ele relata uma fonte diferente mais adequada.If this source is not the one that has relevance to your handling of the event, try checking OriginalSource instead to see if it reports a different source that is more suitable. Para obter mais detalhes sobre os eventos de entrada, consulte visão geral de entrada.For more details on input events, see Input Overview.

Aplica-se a

Veja também