Compartilhar via


Mapas de conexão

Controles OLE são capazes de expor interfaces para outros aplicativos.Essas interfaces permitem somente acesso de um contêiner nesse controle.Se um controle OLE quiser acessar interfaces externas de outros objetos OLE, é necessário estabelecer um ponto de conexão.Esse ponto de conexão permite que um controle de acesso aos mapas de despacho externos, sistema autônomo mapas de evento ou funções de notificação de saída.

A biblioteca Microsoft Foundation classe oferece um modelo de programação que ofereça suporte a pontos de conexão.Nesse modelo, "conexão mapas" são usados para designar interfaces ou pontos de conexão para o controle OLE.Mapas de conexão contém uma macro para cada ponto de conexão.Para obter mais informações sobre mapas de conexão, consulte o CConnectionPoint classe.

Normalmente, um controle suportará apenas dois pontos de conexão: um para eventos e um para notificações de propriedade.Eles são implementados pelo COleControl classe base e não exigem nenhum trabalho adicional, o gravador de controle. Quaisquer pontos de conexão adicionais que você deseja implementar em sua classe devem ser adicionados manualmente.Para oferecer suporte à conexão mapas e pontos, MFC fornece as seguintes macros:

Declaração de MAP de conexão e demarcação

BEGIN_CONNECTION_PART

Declara uma classe incorporada que implementa um ponto de conexão adicionais (deve ser usado na declaração da classe).

END_CONNECTION_PART

Encerra a declaração de um ponto de conexão (deve ser usado na declaração da classe).

CONNECTION_IID

Especifica a ID de interface de ponto de conexão do controle.

DECLARE_CONNECTION_MAP

Declara que um MAP de conexão será usado em uma classe (deve ser usado na declaração da classe).

BEGIN_CONNECTION_MAP

Inicia a definição de um MAP de conexão (deve ser usado na implementação de classe).

END_CONNECTION_MAP

Finaliza a definição de um MAP de conexão (deve ser usado na implementação de classe).

CONNECTION_PART

Especifica um ponto de conexão no MAP de conexão do controle.

As seguintes funções ajudar um coletor de estabelecimento e desconectar uma conexão usando pontos de conexão:

Inicialização/término de pontos de conexão

AfxConnectionAdvise

Estabelece uma conexão entre uma fonte e um coletor.

AfxConnectionUnadvise

Interrompe uma conexão entre uma fonte e um coletor.

Consulte também

Conceitos

Macros do MFC e globais