Macros del objeto de complemento

Estas macros ofrecen compatibilidad con las extensiones de complemento.

Nombre	Descripción
BEGIN_EXTENSION_SNAPIN_NODEINFO_MAP	Marca el principio del mapa de clase de datos de extensión de complemento para un objeto de complemento.
BEGIN_SNAPINTOOLBARID_MAP	Marca el principio del mapa de la barra de herramientas para un objeto de complemento.
END_EXTENSION_SNAPIN_NODEINFO_MAP	Marca el final del mapa de clase de datos de extensión de complemento para un de complemento.
END_SNAPINTOOLBARID_MAP	Marca el final del mapa de la barra de herramientas para un objeto de complemento.
EXTENSION_SNAPIN_DATACLASS	Crea un miembro de datos para la clase de datos de la extensión de complemento.
EXTENSION_SNAPIN_NODEINFO_ENTRY	Escribe una clase de datos de extensión de complemento en el mapa de la misma clase del objeto de complemento.
SNAPINMENUID	Declara el identificador del menú contextual utilizado por el objeto de complemento.
SNAPINTOOLBARID_ENTRY	Escribe una barra de herramientas en el mapa de la barra de herramientas del objeto de complemento.

Requisitos

Encabezado: atlsnap.h

BEGIN_EXTENSION_SNAPIN_NODEINFO_MAP

Marca el principio del mapa de clase de datos de extensión de complemento.

BEGIN_EXTENSION_SNAPIN_NODEINFO_MAP(classname)

Parámetros

classname
[in] El nombre de la clase de datos de extensión de complemento.

Comentarios

Inicie el mapa de extensión de complemento con la macro BEGIN_EXTENSION_SNAPIN_NODEINFO_MAP, agregue entradas para cada uno de los tipos de datos de extensión de complemento con la macro EXTENSION_SNAPIN_NODEINFO_ENTRY y complete el mapa con la macro END_EXTENSION_SNAPIN_NODEINFO_MAP.

Ejemplo

class CMyExtSnapinExtData : 
   public CSnapInItemImpl<CMyExtSnapinExtData>,
   public CMySnapinBase
{
public:
   CMyExtSnapinExtData() {}
};

class CMyExtSnapin : 
   public CComObjectRoot,
   public CSnapInObjectRoot<1, CMyExtSnapin>,
   public IComponentDataImpl<CMyExtSnapin, CMyExtSnapin>
{
public:
   CMyExtSnapin() {}

   BEGIN_COM_MAP(CMyExtSnapin)
   END_COM_MAP()

   EXTENSION_SNAPIN_DATACLASS(CMyExtSnapinExtData)

   BEGIN_EXTENSION_SNAPIN_NODEINFO_MAP(CMyExtSnapin)
      EXTENSION_SNAPIN_NODEINFO_ENTRY(CMyExtSnapinExtData)
   END_EXTENSION_SNAPIN_NODEINFO_MAP()
};

BEGIN_SNAPINTOOLBARID_MAP

Declara el principio del mapa de id. de la barra de herramientas para el objeto de complemento.

BEGIN_SNAPINTOOLBARID_MAP(_class)

Parámetros

_class
[in] Especifica la clase de objeto de complemento.

Ejemplo

class CMySnapinData : 
   public CSnapInItemImpl<CMySnapinData>,
   public CMySnapinBase
{
public:
   CMySnapinData() {}

   BEGIN_SNAPINTOOLBARID_MAP(CMySnapinData)
      // IDR_MYSNAPINTOOLBAR is the resource ID of a toolbar resource.
      SNAPINTOOLBARID_ENTRY(IDR_MYSNAPINTOOLBAR)
   END_SNAPINTOOLBARID_MAP()
};

END_EXTENSION_SNAPIN_NODEINFO_MAP

Marca el final del mapa de clase de datos de la extensión de complemento.

END_EXTENSION_SNAPIN_NODEINFO_MAP()

Comentarios

Inicie la asignación de extensiones de complemento con la macro BEGIN_EXTENSION_SNAPIN_NODEINFO_MAP, agregue entradas para cada uno de los tipos de datos de complemento de extensión con la macro EXTENSION_SNAPIN_NODEINFO_ENTRY y complete el mapa con la macro END_EXTENSION_SNAPIN_NODEINFO_MAP.

Ejemplo

Consulte el ejemplo de BEGIN_EXTENSION_SNAPIN_NODEINFO_MAP.

END_SNAPINTOOLBARID_MAP

Declara el final del mapa de id. de la barra de herramientas para el objeto de complemento.

END_SNAPINTOOLBARID_MAP( _class )

Parámetros

_class
[in] Especifica la clase de objeto de complemento.

Ejemplo

Consulte el ejemplo para BEGIN_SNAPINTOOLBARID_MAP.

EXTENSION_SNAPIN_DATACLASS

Agrega un miembro de datos a la clase de datos de extensión de complemento para una clase derivada de ISnapInItemImpl.

EXTENSION_SNAPIN_DATACLASS(dataClass )

Parámetros

dataClass
[in] La clase de datos de la extensión de complemento.

Comentarios

Esta clase también debe escribirse en un mapa de clase de datos de extensión de complemento. Inicie el mapa de la clase de datos de extensión del complemento con la macro BEGIN_EXTENSION_SNAPIN_NODEINFO_MAP, agregue entradas para cada uno de los tipos de datos de extensión del complemento con la macro EXTENSION_SNAPIN_NODEINFO_ENTRY y complete el mapa con la macro END_EXTENSION_SNAPIN_NODEINFO_MAP.

Ejemplo

class CMyExtSnapinExtData : 
   public CSnapInItemImpl<CMyExtSnapinExtData>,
   public CMySnapinBase
{
public:
   CMyExtSnapinExtData() {}
};

class CMyExtSnapin : 
   public CComObjectRoot,
   public CSnapInObjectRoot<1, CMyExtSnapin>,
   public IComponentDataImpl<CMyExtSnapin, CMyExtSnapin>
{
public:
   CMyExtSnapin() {}

   BEGIN_COM_MAP(CMyExtSnapin)
   END_COM_MAP()

   EXTENSION_SNAPIN_DATACLASS(CMyExtSnapinExtData)

   BEGIN_EXTENSION_SNAPIN_NODEINFO_MAP(CMyExtSnapin)
      EXTENSION_SNAPIN_NODEINFO_ENTRY(CMyExtSnapinExtData)
   END_EXTENSION_SNAPIN_NODEINFO_MAP()
};

EXTENSION_SNAPIN_NODEINFO_ENTRY

Agrega una clase de datos de extensión de complemento al mapa con la misma clase.

EXTENSION_SNAPIN_NODEINFO_ENTRY( dataClass )

Parámetros

dataClass
[in] La clase de datos de la extensión de complemento.

Comentarios

Inicie el mapa de la clase de datos de extensión de complemento con la macro BEGIN_EXTENSION_SNAPIN_NODEINFO_MAP, agregue entradas para cada uno de los tipos de datos de extensión de complemento con la macro EXTENSION_SNAPIN_NODEINFO_ENTRY y complete el mapa con la macro END_EXTENSION_SNAPIN_NODEINFO_MAP.

Ejemplo

Consulte el ejemplo de BEGIN_EXTENSION_SNAPIN_NODEINFO_MAP.

SNAPINMENUID

Utilice esta macro para declarar el recurso del menú contextual del objeto de complemento.

SNAPINMENUID( id )

Parámetros

id
[in] Identifica el menú contextual del objeto de complemento.

SNAPINTOOLBARID_ENTRY

Use esta macro para escribir un id. de la barra de herramientas en el mismo mapa, pero del objeto de complemento.

SNAPINTOOLBARID_ENTRY( id )

Parámetros

id
[in] Identifica el control de la barra de herramientas.

Comentarios

La macro BEGIN_SNAPINTOOLBARID_MAP marca el comienzo del mapa de id. de la barra de herramientas; la macro END_SNAPINTOOLBARID_MAP marca el final.

Ejemplo

Consulte el ejemplo para BEGIN_SNAPINTOOLBARID_MAP.

Consulte también

Macros