RoutedEventHandler Delegar

Definição

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

Observações

O RoutedEventHandler delegado é usado para qualquer evento encaminhado que não reporte informação específica do evento nos dados do evento. Existem muitos desses eventos roteados; exemplos proeminentes incluem Click e Loaded.

A diferença mais notável entre escrever um handler para um evento encaminhado em comparação com um evento geral de runtime de common language (CLR) é que o sender do evento (o elemento onde o handler está ligado e invocado) não pode necessariamente ser considerado a fonte do evento. A fonte é reportada como uma propriedade nos dados do evento (Source). Uma diferença entre sender e Source resulta do evento ser encaminhado para diferentes elementos, durante a travessia do evento encaminhado por uma árvore de elementos.

Pode usar qualquer um sender ou Source para uma referência de objeto se não estiver deliberadamente interessado no comportamento de roteamento de um evento direto ou de bubbling e pretender tratar apenas eventos encaminhados nos elementos onde são inicialmente levantados. Nesta circunstância, sender e Source são o mesmo objeto.

Se pretende tirar partido das características inerentes dos eventos encaminhados e escrever os seus handlers em conformidade, as duas propriedades mais importantes dos dados de eventos com que irá trabalhar ao escrever event handlers são Source e Handled.

Para certas combinações de eventos de entrada e classes de controlo WPF, o elemento que gera o evento não é o primeiro elemento que tem a oportunidade de o gerir. Se o evento de entrada tiver uma versão Pré-visualização do evento, então a raiz da árvore de elementos tem a primeira oportunidade, pode definir Handled como true nos dados partilhados do evento e pode influenciar como o evento de entrada é reportado aos elementos restantes na sua rota de evento. O comportamento de tratamento da Pré-visualização pode dar a impressão de que um determinado evento encaminhado não é levantado como esperado. Para mais informações, consulte Pré-visualização de Eventos e Visão Geral da Entrada.