Clientes de automação: usando bibliotecas de tipos

Os clientes de automação devem ter informações sobre as propriedades e os métodos dos objetos do servidor para que os clientes manipulem os objetos dos servidores. As propriedades têm tipos de dados; métodos geralmente retornam valores e aceitam parâmetros. O cliente requer informações sobre os tipos de dados de todos eles para se vincular estaticamente ao tipo de objeto do servidor.

Este tipo de informação pode ser dado a conhecer de várias formas. A maneira recomendada é criar uma biblioteca de tipos.

Para obter informações sobre MkTypLib, consulte o SDK do Windows.

Visual C++ pode ler um arquivo de biblioteca de tipos e criar uma classe de despacho derivada de COleDispatchDriver. Um objeto dessa classe tem propriedades e operações duplicando as do objeto do servidor. A sua aplicação chama as propriedades e operações deste objeto, e a funcionalidade herdada de COleDispatchDriver reencaminha estas chamadas para o sistema OLE, que, por sua vez, as redireciona para o servidor de objetos.

O Visual C++ mantém automaticamente esse arquivo de biblioteca de tipos para você se você optar por incluir automação quando o projeto foi criado. Como parte de cada compilação, o arquivo .tlb será construído com MkTypLib.

Para criar uma classe de despacho a partir de um arquivo de biblioteca de tipos (.tlb)

1. No Modo de Exibição de Classe ou no Gerenciador de Soluções, clique com o botão direito do mouse no projeto, clique em Adicionar e clique em Adicionar Classe no menu de atalho.

2. Na caixa de diálogo Adicionar classe , selecione a pasta Visual C++/MFC no painel esquerdo. Selecione o ícone MFC Class From TypeLib no painel direito e clique em Abrir.

3. Na caixa de diálogo Assistente de Adição de Classe a partir de Biblioteca de Tipos, selecione uma biblioteca de tipos na lista suspensa de bibliotecas de tipos disponíveis. A caixa Interfaces exibe as interfaces disponíveis para a biblioteca de tipos selecionada.

   Observação

   Você pode selecionar interfaces de mais de uma biblioteca de tipos.

   Para selecionar interfaces, clique duas vezes nelas ou clique no botão Adicionar . Quando você fizer isso, os nomes para as classes de despacho aparecerão na caixa Classes geradas . Você pode editar os nomes das classes na Class caixa.

   A caixa Arquivo exibe o arquivo no qual a classe será declarada. (você também pode editar esse nome de arquivo). Você também pode usar o botão Procurar para selecionar outros arquivos, se preferir ter as informações de cabeçalho e implementação escritas em arquivos existentes ou em um diretório diferente do diretório do projeto.

   Observação

   Todas as classes de despacho para as interfaces selecionadas serão colocadas no arquivo especificado aqui. Se desejar que as interfaces sejam declaradas em cabeçalhos separados, execute este assistente para cada arquivo de cabeçalho que deseja criar.

   Observação

   Algumas informações da biblioteca de tipos podem ser armazenadas em ficheiros com as extensões de ficheiro .DLL, .OCX ou .OLB.

4. Clique em Concluir.

   O assistente gravará o código para suas classes de despacho usando os nomes de classe e arquivo especificados.

Ver também

Clientes de automação