Partilhar via

Classe DeferrableEventArgs

  • Artigo

Uma classe de modelo usada para os tipos de argumento de evento para adiamentos.

Sintaxe

template <typename TEventArgsInterface, typename TEventArgsClass>
class DeferrableEventArgs : public TEventArgsInterface;

Parâmetros

TEventArgsInterface
O tipo de interface que declara os argumentos de um evento adiado.

TEventArgsClass
A classe que implementa TEventArgsInterface.

Membros

Métodos públicos

Nome Descrição
DeferrableEventArgs::GetDeferral Obtém uma referência ao objeto Deferral que representa um evento adiado.
DeferrableEventArgs::InvokeAllFinished Chamado para indicar que todo o processamento para lidar com um evento adiado está concluído.

Comentários

As instâncias dessa classe são passadas para manipuladores de eventos para eventos adiados. Os parâmetros de modelo representam uma interface que define os detalhes dos argumentos de evento de um tipo específico de evento adiado e uma classe que implementa essa interface.

A classe aparece como o primeiro argumento para um manipulador de eventos de um evento adiado. Você pode chamar o método GetDeferral para obter o objeto Deferral do qual pode extrair todas as informações sobre o evento adiado. Depois de concluir a manipulação do evento, chame Complete no objeto Deferral. Em seguida, chame InvokeAllFinished no final do método do manipulador de eventos, o que garante que a conclusão de todos os eventos adiados seja comunicada corretamente.

Requisitos

Cabeçalho: event.h

Namespace: Microsoft::WRL

DeferrableEventArgs::GetDeferral

Obtém uma referência ao objeto Deferral que representa um evento adiado.

HRESULT GetDeferral([out, retval] Windows::Foundation::IDeferral** result)

Parâmetros

result
Um ponteiro que fará referência ao objeto Deferral quando a chamada for concluída.

Valor de retorno

S_OK se tiver êxito; caso contrário, um HRESULT que indica o erro.

DeferrableEventArgs::InvokeAllFinished

Chamado para indicar que todo o processamento para lidar com um evento adiado está concluído.

void InvokeAllFinished()

Comentários

Você deve chamar esse método depois que a origem do evento chamar InvokeAll. Chamar esse método impede o uso de adiamentos adicionais e força o manipulador de conclusão a ser executado se nenhum adiamento for feito.