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 se os clientes forem manipular os objetos dos servidores. As propriedades têm tipos de dados; os métodos geralmente retornam valores e aceitam parâmetros. O cliente requer informações sobre os tipos de dados de todos eles para associar estaticamente ao tipo de objeto do servidor.

Essas informações de tipo podem ser conhecidas de várias maneiras. A maneira recomendada é criar uma biblioteca de tipos.

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

O Visual C++ pode ler um arquivo de biblioteca de tipos e criar uma classe de despacho derivada do COleDispatchDriver. Um objeto dessa classe tem propriedades e operações duplicando as do objeto de servidor. Seu aplicativo chama as propriedades e operações desse objeto, e a funcionalidade herdada do COleDispatchDriver roteia essas chamadas para o sistema OLE, que, por sua vez, as direciona para o objeto servidor.

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

Para criar uma classe de expedição 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 e clique em Adicionar e então 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 a classe MFC do ícone TypeLib no painel direito e clique em Abrir.

3. Na caixa de diálogo Adicionar classe do Assistente Typelib, selecione uma biblioteca de tipos na lista suspensa 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 neles ou clique no botão Adicionar . Quando você fizer isso, os nomes das classes de expedição serão exibidos na caixa Classes Geradas. Você pode editar os nomes de classe 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, caso prefira 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 quiser que as interfaces sejam declaradas em cabeçalhos separados, execute este assistente para cada arquivo de cabeçalho que você deseja criar.

   Observação

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

4. Clique em Concluir.

   Em seguida, o assistente escreverá o código para suas classes de expedição usando os nomes de classe e arquivo especificados.

Consulte também

Clientes de automação