event_receiver

Artigo
02/25/2013

Cria um receptor de eventos (coletor).

[ event_receiver(
   type 
   [, layout_dependent=false] 
) ]

Parâmetros

type
Uma enumeração de um dos seguintes valores:
- nativepara código C/C++ não gerenciado (o padrão para as classes nativas).
- compara o código de COM.Esse valor exige que você incluir os seguintes arquivos de cabeçalho:
```
   #define _ATL_ATTRIBUTES
   #include <atlbase.h>
   #include <atlcom.h>
```
layout_dependent
Especificar layout_dependent somente se type=com.layout_dependent é um booleano:
- True significa que a assinatura dos delegados no caso de receptor deve corresponder exatamente àqueles aos quais eles são conectados o fonte.Os nomes de manipulador do evento receptor devem coincidir com os nomes especificados na interface de origem do evento relevantes.Você deve usar coclass quando layout_dependent é true.É um pouco mais eficiente para especificar true.
- False (padrão) significa que a classe de armazenamento e a convenção de chamada (virtual, estático e outros) não precisa coincidir com o método de eventos e os manipuladores; nem os nomes de manipulador precisa coincidir com os nomes de método de interface de origem evento.

Comentários

O event_receiver atributo C++ Especifica que a classe ou estrutura à qual ela é aplicada será um receptor de eventos, usando o modelo de evento unificado do Visual C++.

event_receiver é usado com o event_source atributo e o __hook e __unhook as palavras-chave.Use event_source para criar origens de eventos.Use __hook dentro de métodos de um receptor de eventos para associar os métodos de receptor de eventos ("hook") para os eventos de uma fonte de evento.Use __unhook para dissociá-los.

layout_dependent é especificada somente para receptores de evento COM (type=com).O padrão para layout_dependent é false.

Observação
Modelado class ou struct não pode conter eventos.

Requisitos

Contexto de atributo

Se aplica a	classe,struct
Reproduzíveis	Não
Atributos obrigatórios	coclass quando layout_dependent=true
Atributos inválidos	Nenhum