event_receiver

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.

Requisitos

Contexto de atributo

Se aplica a

clase, struct

repetible

No

Atributos necesarios

CoClass cuando layout_dependent=TRUE

Atributos no válidos

None

Para obtener más información, vea Contextos de atributo.

Vea también

Referencia

event_source

__event

__hook

__unhook

Otros recursos

Atributos del compilador

Atributos

Attributes Samples