Compartilhar via


Etapa 2: adicionando um controle

Em esta etapa, você irá adicionar um controle ao seu projeto, compilá-lo e, testar-o-&z em uma página da Web.

Procedimentos

Para adicionar um objeto a um projeto ATL

  1. Em o modo da classe, clique com o botão direito do mouse no projeto polígono.

  2. Ponto a Adicionar no menu de atalho, clique em e Adicionar Classe submenu.

    a caixa de diálogo de Adicionar Classe aparece.As categorias diferentes do objeto são listadas na estrutura de árvore à esquerda.

  3. Clique na pasta de ATL .

  4. Em a lista de modelos em Controle do ATLdireito, selecione.Clique em Adicionar.O assistente de controle de ATL abrirá, e você pode configurar o controle.

  5. Digite PolyCtl como o nome e a sucintos observe que os outros campos são concluídos automaticamente.Não clique Concluir ainda, porque você precisa fazer algumas alterações.

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

Campo

Sumário

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 projetado para conter a definição de classe C++.

Arquivo de .cpp

O arquivo projetado para conter a implementação da classe C++.

CoClass

O nome da classe componente para esse controle.

Interface

O nome da interface em que o controle irá implementar seus métodos e propriedades personalizadas.

Tipo

Uma descrição para o controle.

ProgID

O nome legível que pode ser usado para pesquisar o CLSID do controle.

Você precisa fazer várias configurações adicionais no assistente de controle de ATL.

Para ativar o suporte para pontos ricos de informações de conexão e de erro

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

  2. Selecione a caixa de seleção de pontos de conexão .Isso criará o suporte para uma interface de saída no arquivo de IDL.

Você também pode fazer o controle insertable, o que significa que eles podem ser inseridos em aplicativos que suportam objetos inseridos, como o excel ou palavras.

Para tornar o controle insertable

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

  2. Selecione a caixa de seleção de Insertable , que será limpa por padrão.

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

Para adicionar uma cor de preenchimento armazene a propriedade e crie o controle

  1. Clique Armazena propriedades para abrir a página de Armazena propriedades .

  2. Em Sem Suporte, role para baixo da lista de propriedades pré-definidas possíveis.Clique duas vezes Fill Color para movê-lo à lista de Com Suporte .

  3. Isso conclui as opções para o controle.Clique em Concluir.

Porque o assistente criou o controle, várias alterações de código e adições do arquivo ocorreram.Os seguintes arquivos foram criados:

File

Descrição

PolyCtl.h

Contém a maioria da implementação da classe CPolyCtlC++.

PolyCtl.cpp

Contém as outras partes de CPolyCtl.

PolyCtl.rgs

Um arquivo de texto que contém 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 executar as seguintes alterações de código a seguir:

  • Adicionada uma instrução de #include ao stdafx.h e stdafx.cpp arquivos para incluir arquivos de ATL necessários para controles de suporte.

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

  • Adicionar o novo controle ao mapeamento de objeto em Polygon.cpp.

Agora você pode compilar o controle para sua consulta em ação.

Compilação e teste o controle

Para criar e testar o controle

  • Em o menu de Compilar , clique em Polígonos de compilação.

    Uma vez que o controle concluir a criação, clique com o botão direito do mouse PolyCtl.htm no solution Explorer e seleciona Exibir no navegador.A página da Web HTML que contém o controle será exibida.Você deve ver uma página com o título de “página de teste ATL 8,0 para o objeto PolyCtl” e o texto PolyCtl.Este é o seu controle.

ObservaçãoObservação

Para concluir este tutorial, se você receber uma mensagem de erro no arquivo DLL não pode ser criado, feche o arquivo PolyCtl.htm e o recipiente de teste do controle ActiveX e crie a solução novamente.Se você ainda não pode criar o DLL, reinicializar o computador ou fazer logoff (se você estiver usando serviços de terminal.)

Em seguida, você adicionará uma propriedade personalizado para o controle.

De volta para a etapa 1 | a etapa 3

Consulte também

Referência

Tutorial de ATL