Adicionando um controle (Tutorial ATL, parte 2)

  • Artigo

Nesta etapa, você adicionará um controle ao projeto, o criará e o testará em uma página da Web.

Procedimentos

Para adicionar um objeto a um projeto da ATL

  1. No Gerenciador de Soluções, clique com o botão direito do mouse no projeto Polygon.

  2. Aponte para Adicionar no menu de atalho e clique em Novo Item no submenu.

    A caixa de diálogo Adicionar Novo Item aparecerá. As diferentes categorias de objeto são listadas na estrutura da árvore à esquerda.

  3. Clique na pasta ATL.

  4. Na lista de modelos à direita, selecione Controle da ATL. Clique em Adicionar. O assistente Controle da ATL será aberto e você poderá configurar o controle.

  5. Digite PolyCtl como o nome curto e observe que os outros campos serão concluídos automaticamente. Não clique em Concluir ainda, pois você deve fazer mais algumas alterações.

A página Nomes do assistente de Controle da ATL contém os seguintes campos:

Campo Sumário
Nome curto O nome que você inseriu para o controle.
Classe O nome da classe C++ criada para implementar o controle.
Arquivo .h O arquivo criado para conter a definição da classe C++.
Arquivo .cpp O arquivo criado para conter a implementação da classe C++.
CoClass O nome da classe de componente para esse controle.
Interface O nome da interface na qual o controle implementará seus métodos e propriedades personalizados.
Tipo Uma descrição para o controle.
ProgID O nome legível que pode ser usado para pesquisar o CLSID do controle.

Você encontrará várias configurações adicionais que devem ser alteradas no assistente de Controle da ATL.

Para habilitar o suporte para informações de erro avançadas e pontos de conexão

  1. Clique em Opções para abrir a página Opções.

  2. Marque a caixa de seleção Pontos de conexão. Essa opção cria suporte para uma interface de saída no arquivo IDL.

Você também pode adicionar interfaces para estender a funcionalidade do controle.

Para estender a funcionalidade do controle

  1. Clique em Interfaces para abrir a página Interfaces.

  2. Selecione IProvideClassInfo2 e clique na seta para cima para movê-la para a lista Com suporte.

  3. Selecione ISpecifyPropertyPages e clique na seta para cima para movê-la para a lista Com suporte.

Você também pode tornar o controle inserível, o que significa que ele é inserível em aplicativos que dão suporte a objetos inseridos, como Excel ou Word.

Para tornar o controle inserível

  1. Clique em Aparência para abrir a página Aparência.

  2. Marque a caixa de seleção Inserível.

O polígono exibido pelo objeto terá uma cor de preenchimento sólida, portanto, você precisará adicionar uma propriedade de estoque Fill Color.

Para adicionar uma propriedade de estoque Cor de Preenchimento e criar o controle

  1. Clique em Propriedades de Estoque para abrir a página Propriedades de Estoque.

  2. Em Não há suporte, role para baixo a lista de possíveis propriedades de estoque. Selecione Fill Color e clique na seta para cima para movê-la para a lista Com suporte.

  3. Escolha Concluir.

À medida que o assistente cria o controle, várias alterações de código e adições de arquivo ocorrem. Os seguintes arquivos são criados:

Arquivo Descrição
PolyCtl.h Contém a maior parte da implementação da classe CPolyCtl do C++.
PolyCtl.cpp Contém as partes restantes de CPolyCtl.
PolyCtl.rgs Um arquivo de texto que contém o script do Registro usado para registrar o controle.
PolyCtl.htm Uma página da Web que contém uma referência ao controle recém-criado.

O assistente também faz as seguintes alterações de código:

  • Adiciona uma instrução #include aos arquivos de cabeçalho pré-compilado para incluir os arquivos da ATL necessários para dar suporte aos controles.

  • Altera Polygon.idl para incluir detalhes do novo controle.

  • Adiciona o novo controle ao mapa do objeto em Polygon.cpp.

Agora você pode criar o controle para vê-lo em ação.

Compilação e teste do controle

Para criar e testar o controle

  1. No menu Criar, clique em Criar Polígono.

    Depois que o controle terminar a criação, clique com o botão direito do mouse em PolyCtl.htm no Gerenciador de Soluções e selecione Exibir no Navegador. A página da Web HTML que contém o controle é exibida. Você deve ver uma página com o título "Página de teste da ATL 8.0 para o objeto PolyCtl" e seu controle, o PolyCtl de texto.

Observação

Se o controle não estiver visível, saiba que alguns navegadores exigem ajustes de configurações para executar controles ActiveX. Consulte a documentação do navegador sobre como habilitar controles ActiveX.

Observação

Ao concluir este tutorial, se você receber uma mensagem de erro informando que o arquivo DLL não pode ser criado, feche o arquivo PolyCtl.htm e o contêiner de Teste de Controle ActiveX e crie a solução novamente. Se você ainda não conseguir criar a DLL, reinicialize o computador ou faça logoff se estiver usando os Serviços de Terminal.

Em seguida, você adicionará uma propriedade personalizada ao controle.

Voltar para a Etapa 1 | Na Etapa 3

Confira também

Tutorial