event_receiver

Artículo
06/09/2015

Crea un receptor de eventos (receptor).

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

Parámetros

type
Una enumeración de uno de los siguientes valores:
- native para código no administrado de C/C++ (valor predeterminado para las clases nativas).
- com para código COM. Este valor debe incluir los archivos de encabezado siguientes:
```
   #define _ATL_ATTRIBUTES
   #include <atlbase.h>
   #include <atlcom.h>
```
layout_dependent
Especifique layout_dependent sólo si type=COM. layout_dependent es un valor booleano:
- TRUE significa que la firma de los delegados en el receptor de eventos debe coincidir exactamente con los que se enlazan en el origen de evento. Los nombres de controlador de receptor de eventos deben coincidir con los nombres especificados en la interfaz pertinente del origen de eventos. Debe utilizar CoClass cuando es layout_dependent es TRUE. Es ligeramente más eficaz especificar TRUE.
- Falso (valor predeterminado) significa que la convención de llamada y la clase de almacenamiento (virtual, estático, etc.) no tienen que coincidir el método del evento y controladores; ni tampoco el controlador que los nombres deben coincidir con los nombres de interfaz del origen de eventos.

Comentarios

El atributo de event_receiver C++ especifica que la clase o la estructura a las que se aplica se receptor de eventos, mediante el modelo de eventos de Visual C++.

event_receiver se utiliza con el atributo de event_source y palabras clave de __hook y de __unhook . uso event_source de crear orígenes de eventos. Utilice __hook dentro de los métodos de un receptor de eventos para asociar (“enlazar”) método de receptor de eventos a los eventos de un origen de eventos. uso __unhook de disociarlos.

layout_dependent solamente se especifica para los receptores de eventos COM (type=COM). El valor predeterminado para layout_dependent es Falso.

Nota

Una clase o struct basada en plantilla no puede contener eventos.