Partilhar via

Adicionando um controle (ATL Tutorial, Parte 2)

Nesta etapa, você adiciona um controle ao seu projeto, cria-o e testa-o em uma página da Web.

Procedimentos

Para adicionar um objeto a um projeto ATL

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

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

    A caixa de diálogo Adicionar Novo Item é exibida. As diferentes categorias de objetos são listadas na estrutura em árvore à esquerda.

  3. Clique na pasta ATL .

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

  5. Digite PolyCtl como o nome abreviado e observe que os outros campos são preenchidos automaticamente. Não clique em Concluir ainda, porque você deve fazer mais algumas alterações.

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

Campo Conteúdos
Nome curto O nome que você inseriu para o controle.
Classe O nome da classe C++ criado 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++.
Coclasse 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 procurar o CLSID do controle.

No assistente de controlo ATL, encontrará várias configurações adicionais que devem ser alteradas.

Para habilitar suporte para informações de erro detalhadas 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 . Esta 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ê-lo para a lista Suportado .

  3. Selecione ISpecifyPropertyPages e clique na seta para cima para movê-lo para a lista Suportado .

Você também pode tornar o controle inserível, o que significa que ele pode ser incorporado em aplicativos que suportam objetos incorporados, 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 Inserível.

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

Para adicionar uma propriedade pré-definida de Cor de Preenchimento e criar o controlo

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

  2. Em Não suportado, role para baixo a lista de possíveis propriedades de estoque. Selecione Fill Color e clique na seta para cima para movê-lo para a lista Suportado .

  3. Escolha Concluir.

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

Ficheiro Descrição
PolyCtl.h Contém a maior parte da implementação da classe CPolyCtlC++.
PolyCtl.cpp Contém as partes restantes do CPolyCtl.
PolyCtl.rgs Um arquivo de texto que contém o script de 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 ficheiros de cabeçalho pré-compilados para incluir os ficheiros ATL necessários ao suporte de controlos.

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

  • Adiciona o novo controle ao mapa de objetos no Polygon.cpp.

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

Construindo e testando o controle

Para criar e testar o controle

  1. No menu Build , clique em Build Polygon.

    Quando o controle terminar de criar, 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 "ATL 8.0 test page for object PolyCtl", e seu controle, o texto PolyCtl.

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 Teste de Controle ActiveX e crie a solução novamente. Se ainda não conseguir criar a DLL, reinicie o computador ou termine sessão se estiver a utilizar os Serviços de Terminal.

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

Voltar ao Passo 1 | Rumo ao Passo 3

Ver também

Tutoriais

  • Last updated on