Compartilhar via

Macros de objeto Snap-In

  • Artigo

Essas macros oferecem suporte para extensões snap-in.

Nome Descrição
BEGIN_EXTENSION_SNAPIN_NODEINFO_MAP Marca o início do mapa da classe de dados da extensão snap-in para um objeto Snap-In.
BEGIN_SNAPINTOOLBARID_MAP Marca o início do mapa da barra de ferramentas para um objeto Snap-In.
END_EXTENSION_SNAPIN_NODEINFO_MAP Marca o final do mapa da classe de dados da extensão snap-in para um objeto Snap-In.
END_SNAPINTOOLBARID_MAP Marca o final do mapa da barra de ferramentas para um objeto Snap-In.
EXTENSION_SNAPIN_DATACLASS Cria um membro de dados para a classe de dados da extensão snap-in.
EXTENSION_SNAPIN_NODEINFO_ENTRY Insere uma classe de dados de extensão snap-in no mapa da classe de dados de extensão snap-in do objeto Snap-In.
SNAPINMENUID Declara a ID do menu de contexto usado pelo objeto Snap-In.
SNAPINTOOLBARID_ENTRY Insere uma barra de ferramentas no mapa da barra de ferramentas do objeto Snap-In.

Requisitos

Cabeçalho: atlsnap.h

BEGIN_EXTENSION_SNAPIN_NODEINFO_MAP

Marca o início do mapa da classe de dados da extensão snap-in.

BEGIN_EXTENSION_SNAPIN_NODEINFO_MAP(classname)

Parâmetros

classname
[entrada] O nome da classe de dados da extensão snap-in.

Comentários

Inicie o mapa da extensão snap-in com a macro BEGIN_EXTENSION_SNAPIN_NODEINFO_MAP, adicione entradas para cada um dos tipos de dados da extensão snap-in com a macro EXTENSION_SNAPIN_NODEINFO_ENTRY e conclua o mapa com a macro END_EXTENSION_SNAPIN_NODEINFO_MAP.

Exemplo

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 o início do mapa da ID da barra de ferramentas para o objeto Snap-In.

BEGIN_SNAPINTOOLBARID_MAP(_class)

Parâmetros

_class
[entrada] Especifica a classe do objeto Snap-In.

Exemplo

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 o final do mapa da classe de dados da extensão snap-in.

END_EXTENSION_SNAPIN_NODEINFO_MAP()

Comentários

Inicie o mapa da extensão snap-in com a macro BEGIN_EXTENSION_SNAPIN_NODEINFO_MAP, adicione entradas para cada um dos tipos de dados da extensão snap-in com a macro EXTENSION_SNAPIN_NODEINFO_ENTRY e conclua o mapa com a macro END_EXTENSION_SNAPIN_NODEINFO_MAP.

Exemplo

Confira o exemplo de BEGIN_EXTENSION_SNAPIN_NODEINFO_MAP.

END_SNAPINTOOLBARID_MAP

Declara o final do mapa da ID da barra de ferramentas para o objeto Snap-In.

END_SNAPINTOOLBARID_MAP( _class )

Parâmetros

_class
[entrada] Especifica a classe do objeto Snap-In.

Exemplo

Confira o exemplo de BEGIN_SNAPINTOOLBARID_MAP.

EXTENSION_SNAPIN_DATACLASS

Adiciona um membro de dados à classe de dados da extensão snap-in para uma classe derivada de ISnapInItemImpl.

EXTENSION_SNAPIN_DATACLASS(dataClass )

Parâmetros

dataClass
[entrada] A classe de dados da extensão snap-in.

Comentários

Essa classe também deve ser inserida em um mapa da classe de dados da extensão snap-in. Inicie o mapa da classe de dados da extensão snap-in com a macro BEGIN_EXTENSION_SNAPIN_NODEINFO_MAP, adicione entradas para cada um dos tipos de dados da extensão snap-in com a macro EXTENSION_SNAPIN_NODEINFO_ENTRY e conclua o mapa com a macro END_EXTENSION_SNAPIN_NODEINFO_MAP.

Exemplo

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

Adiciona uma classe de dados da extensão snap-in ao mapa da classe de dados da extensão snap-in.

EXTENSION_SNAPIN_NODEINFO_ENTRY( dataClass )

Parâmetros

dataClass
[entrada] A classe de dados da extensão snap-in.

Comentários

Inicie o mapa da classe de dados da extensão snap-in com a macro BEGIN_EXTENSION_SNAPIN_NODEINFO_MAP, adicione entradas para cada um dos tipos de dados da extensão snap-in com a macro EXTENSION_SNAPIN_NODEINFO_ENTRY e conclua o mapa com a macro END_EXTENSION_SNAPIN_NODEINFO_MAP.

Exemplo

Confira o exemplo de BEGIN_EXTENSION_SNAPIN_NODEINFO_MAP.

SNAPINMENUID

Use essa macro para declarar o recurso de menu de contexto do objeto Snap-In.

SNAPINMENUID( id )

Parâmetros

id
[entrada] Identifica o menu de contexto do objeto Snap-In.

SNAPINTOOLBARID_ENTRY

Use essa macro para inserir uma ID da barra de ferramentas no mapa de ID da barra de ferramentas do objeto Snap-In.

SNAPINTOOLBARID_ENTRY( id )

Parâmetros

id
[entrada] Identifica o controle da barra de ferramentas.

Comentários

A macro BEGIN_SNAPINTOOLBARID_MAP marca o início do mapa da ID da barra de ferramentas; a macro END_SNAPINTOOLBARID_MAP marca o final.

Exemplo

Confira o exemplo de BEGIN_SNAPINTOOLBARID_MAP.

Confira também

Macros