Partilhar via


Macros de Pontos de Ligação

Observação

A Active Template Library (ATL) continua a ser suportada. No entanto, já não estamos a adicionar funcionalidades nem a atualizar a documentação.

Estas macros definem mapas de pontos de ligação e entradas.

Macro Description
BEGIN_CONNECTION_POINT_MAP Marca o início das entradas do mapa dos pontos de ligação.
CONNECTION_POINT_ENTRY Insere pontos de ligação no mapa.
CONNECTION_POINT_ENTRY_P (Visual Studio 2017) Semelhante ao CONNECTION_POINT_ENTRY mas leva um indicador para o IID.
END_CONNECTION_POINT_MAP Marca o fim das entradas do mapa de pontos de ligação.

Requerimentos

Cabeçalho: atlcom.h

BEGIN_CONNECTION_POINT_MAP

Marca o início das entradas do mapa dos pontos de ligação.

BEGIN_CONNECTION_POINT_MAP(x)

Parâmetros

x
[dentro] O nome da classe que contém os pontos de ligação.

Observações

Começa o mapa dos pontos de ligação com o macro BEGIN_CONNECTION_POINT_MAP, adiciona entradas para cada um dos teus pontos de ligação com o macro CONNECTION_POINT_ENTRY e completa o mapa com o macro END_CONNECTION_POINT_MAP .

Para mais informações sobre pontos de ligação em ATL, consulte o artigo Pontos de Ligação.

Example

BEGIN_CONNECTION_POINT_MAP(CPolyCtl)
   CONNECTION_POINT_ENTRY(__uuidof(_IPolyCtlEvents))
END_CONNECTION_POINT_MAP()

CONNECTION_POINT_ENTRY e CONNECTION_POINT_ENTRY_P

Insere um ponto de ligação para a interface especificada no mapa de pontos de ligação para que possa ser acedido.

CONNECTION_POINT_ENTRY(iid)
CONNECTION_POINT_ENTRY_P(piid) // (Visual Studio 2017)

Parâmetros

IID
[dentro] O GUID da interface que está a ser adicionado ao mapa do ponto de ligação.

Piid
[dentro] Aponta para o GUID da interface que está a ser adicionada.

Observações

As entradas de pontos de ligação no mapa são usadas pelo IConnectionPointContainerImpl. A classe que contém o mapa de pontos de ligação deve herdar de IConnectionPointContainerImpl.

Começa o mapa dos pontos de ligação com a macro BEGIN_CONNECTION_POINT_MAP , adiciona entradas para cada um dos teus pontos de ligação com a macro CONNECTION_POINT_ENTRY e completa o mapa com a macro END_CONNECTION_POINT_MAP .

Para mais informações sobre pontos de ligação em ATL, consulte o artigo Pontos de Ligação.

Example

class ATL_NO_VTABLE CConnect2 :
   public CComObjectRootEx<CComSingleThreadModel>,
   public CComCoClass<CConnect2, &CLSID_Connect2>,
   public IConnectionPointContainerImpl<CConnect2>,
   public IPropertyNotifySinkCP<CConnect2>
{
public:
   BEGIN_CONNECTION_POINT_MAP(CConnect2)
      CONNECTION_POINT_ENTRY(IID_IPropertyNotifySink)
   END_CONNECTION_POINT_MAP()

   // Remainder of class declaration omitted.

END_CONNECTION_POINT_MAP

Marca o fim das entradas do mapa de pontos de ligação.

END_CONNECTION_POINT_MAP()

Observações

Começa o mapa dos pontos de ligação com a macro BEGIN_CONNECTION_POINT_MAP , adiciona entradas para cada um dos teus pontos de ligação com a macro CONNECTION_POINT_ENTRY e completa o mapa com a macro END_CONNECTION_POINT_MAP.

Para mais informações sobre pontos de ligação em ATL, consulte o artigo Pontos de Ligação.

Example

BEGIN_CONNECTION_POINT_MAP(CMyComponent)
   CONNECTION_POINT_ENTRY(__uuidof(_IMyComponentEvents))
END_CONNECTION_POINT_MAP()

Consulte também

Macros
Funções globais de pontos de ligação