RoutedEventHandler Delegar

Definição

Namespace:

System.Windows

Assembly:

PresentationCore.dll

Representa o método que manipulará vários eventos roteados que não têm dados de evento específicos além dos dados comuns a todos os eventos roteados.

public delegate void RoutedEventHandler(System::Object ^ sender, RoutedEventArgs ^ e);

public delegate void RoutedEventHandler(object sender, RoutedEventArgs e);

type RoutedEventHandler = delegate of obj * RoutedEventArgs -> unit

Public Delegate Sub RoutedEventHandler(sender As Object, e As RoutedEventArgs)

Parâmetros

sender

Object

O objeto em que o manipulador de eventos está anexado.

e

RoutedEventArgs

Os dados do evento.

Comentários

O RoutedEventHandler delegado é usado para qualquer evento roteado que não relate informações específicas do evento nos dados do evento. Há muitos eventos roteado; exemplos proeminentes incluem Click e Loaded.

A diferença mais notável entre gravar um manipulador para um evento roteado em vez de um evento CLR (Common Language Runtime) geral é que o sender do evento (o elemento em que o manipulador é anexado e invocado) não pode ser considerado necessariamente a origem do evento. A origem é relatada como uma propriedade nos dados do evento (Source). Uma diferença entre sender e Source é o resultado do evento ser roteado para elementos diferentes, durante a passagem do evento roteado por meio de uma árvore de elementos.

Você pode usar ou senderSource para uma referência de objeto se não estiver deliberadamente interessado no comportamento de roteamento de um evento roteado direto ou borbulhante e pretende apenas lidar com eventos roteado nos elementos em que eles são gerados pela primeira vez. Nessa circunstância, sender e Source são o mesmo objeto.

Se você pretende aproveitar os recursos inerentes dos eventos roteados e gravar seus manipuladores adequadamente, as duas propriedades mais importantes dos dados de evento com as quais você trabalhará ao escrever manipuladores de eventos são Source e Handled.

Para determinadas combinações de eventos de entrada e classes de controle WPF, o elemento que aciona o evento não é o primeiro elemento que tem a oportunidade de lidar com ele. Se o evento de entrada tiver uma versão prévia do evento, a raiz da árvore de elementos terá a primeira oportunidade, poderá ser definida Handledtrue como nos dados de evento compartilhado e poderá influenciar como o evento de entrada é relatado aos elementos restantes em sua rota de evento. O comportamento de manipulação de visualização pode dar a aparência de que um evento roteado específico não é gerado conforme o esperado. Para obter mais informações, consulte Visualizar eventos e visão geral de entrada.

Métodos de Extensão