Compartilhar via


UIElement.AddHandler(RoutedEvent, Object, Boolean) Método

Definição

Adiciona um manipulador de eventos roteados de um evento roteado especificado, adicionando o manipulador à coleção de manipuladores no elemento atual. Especifique handledEventsToo como true para que o manipulador fornecido seja invocado mesmo se o evento for tratado em outro lugar.

public:
 virtual void AddHandler(RoutedEvent ^ routedEvent, Platform::Object ^ handler, bool handledEventsToo) = AddHandler;
void AddHandler(RoutedEvent const& routedEvent, IInspectable const& handler, bool const& handledEventsToo);
public void AddHandler(RoutedEvent routedEvent, object handler, bool handledEventsToo);
function addHandler(routedEvent, handler, handledEventsToo)
Public Sub AddHandler (routedEvent As RoutedEvent, handler As Object, handledEventsToo As Boolean)

Parâmetros

routedEvent
RoutedEvent

Um identificador do evento roteado a ser manipulado.

handler
Object

Platform::Object

IInspectable

Uma referência à implementação do manipulador.

handledEventsToo
Boolean

bool

true para registrar o manipulador de modo que ele seja invocado mesmo quando o evento roteado é marcado como manipulado em seus dados de evento.

false para registrar o manipulador com a condição padrão que ele não será invocado se o evento roteado já estiver marcado como manipulado. O padrão é false.

Não peça rotineiramente para manipular novamente um evento roteado, pois ele interfere no design pretendido do sistema de eventos Windows Runtime para composição de controle.

Exemplos

Este exemplo mostra a sintaxe básica para fiação de um manipulador de eventos com AddHandler e handledEventsToo como true. Nesse caso, o evento que está sendo conectado é Tocado. O local típico para manipuladores de fio é Carregado para uma página ou OnApplyTemplate para um controle modelo.

void MainPage::pageRoot_Tapped(Platform::Object^ sender, Windows::UI::Xaml::Input::TappedRoutedEventArgs^ e)
{
     //implementation
}
void MainPage::pageRoot_Loaded(Platform::Object^ sender, Windows::UI::Xaml::RoutedEventArgs^ e)
{
     this->AddHandler(UIElement::TappedEvent, ref new TappedEventHandler(this, &MainPage::pageRoot_Tapped), true);
}
private void pageRoot_Tapped(object sender, TappedRoutedEventArgs e)
{
    //implementation
}
private void pageRoot_Loaded_1(object sender, RoutedEventArgs e)
{
    this.AddHandler(UIElement.TappedEvent, new TappedEventHandler(pageRoot_Tapped), true);
}

Comentários

Não tente usar AddHandler como um substituto geral para a sintaxe específica do idioma que você normalmente usa para manipuladores de eventos de fiação; ela não funcionará, pois nem todos os eventos têm um identificador que você pode passar como routedEvent. AddHandler é especificamente para eventos roteados e destina-se principalmente ao cenário específico habilitado passando handledEventsToo como true. Para saber mais, confira Visão geral de eventos e eventos roteados.

Identificadores de eventos roteado

O identificador de evento roteado geralmente é um membro de propriedade estática de UIElement. Por exemplo, para adicionar um manipulador para o evento KeyUp , passe KeyUpEvent para esse parâmetro. Apenas um pequeno número de eventos Windows Runtime têm esse identificador; somente eventos roteado no UIElement têm uma API de identificador disponível para esse uso. Geralmente, são eventos relacionados a ações de entrada em vários níveis: nível de ponteiro, nível de gesto, nível de manipulação. Além disso, os principais eventos de entrada podem ser tratados dessa maneira.

Aqui está uma lista de eventos roteados que expõem um identificador de evento roteado e, portanto, podem ser processados por manipuladores registrados por uma AddHandler chamada:

O parâmetro de manipulador

O handler parâmetro é um parâmetro não tipado, mas você deve fornecer um novo delegado que faça referência a um método de manipulador específico ao evento desejado. Por exemplo, se estiver tratando um evento KeyUp , passe uma nova instância KeyEventHandler que faça referência a um método baseado nessa KeyEventHandler assinatura delegada. Isso requer uma desreferência e a sintaxe de desreferência varia dependendo de qual idioma você está usando. Confira os exemplos neste tópico.

Quando usar handledEventsToo

Processar eventos de entrada de baixo nível de forma prática é uma tarefa complexa. Muitos controles implementam o comportamento em que um determinado evento é marcado como manipulado e é substituído por outro evento mais intuitivo. Em geral, um controle marcará um evento roteado como tratado somente se houver alguma intenção de design para fazer isso. No entanto, em determinados cenários, essas intenções de design podem não ser o que seu tratamento específico do evento de entrada requer. É para esses cenários que o registro de manipuladores com handledEventsToo o true é apropriado. Mas você não deve fazer isso rotineiramente. Invocar manipuladores em resposta a todos os eventos, mesmo se tratados, complicará sua própria lógica de processamento de eventos do aplicativo. Você poderá ver uma diminuição no desempenho se a lógica do manipulador for substancial. Você deve anexar manipuladores a eventos já tratados somente se tiver descoberto que determinados controles estão tratando eventos que você deseja lidar com a lógica do aplicativo.

Outra técnica para evitar o comportamento de manipulação de classe de um controle é subclasse que controla e substitui seus métodos OnEvent , que são substituições pré-configuradas pelas quais o controle marca um evento como manipulado. No entanto, isso também pode ser complexo. Talvez seja necessário reproduzir a implementação de tratamento de um controle sem chamar a implementação base, pois a implementação base marcaria o evento como manipulado. Para saber mais, confira Visão geral de eventos e eventos roteados.

Aplica-se a

Confira também