Assistente de Controlo ATL

Insere num projeto ATL (ou num projeto MFC com suporte ATL) um controlo ATL. Pode usar este assistente para inserir um de três tipos de controlos:

• Controlo padrão

• Controlo composto

• Controlo DHTML

Além disso, pode especificar um controlo mínimo, removendo as interfaces da lista de Interfaces , que são fornecidas como predefinidos para a abertura dos controlos na maioria dos contentores. Podes definir as interfaces que queres suportar para o controlo na página de Interfaces do assistente.

Observações

O script de registo produzido por este assistente irá registar os seus componentes COM sob HKEY_CURRENT_USER em vez de HKEY_LOCAL_MACHINE. Para modificar este comportamento, defina a opção Register for all users do ATL Wizard.

Names

Especifique os nomes do objeto, interface e classes a adicionar ao seu projeto. Exceto pelo nome curto, todas as outras caixas podem ser alteradas independentemente. Se alterar o texto para Nome Curto, a alteração reflete-se nos nomes de todas as outras caixas desta página. Se mudares o nome da Coclasse na secção COM, a alteração é refletida na caixa Type , mas o nome da Interface e o ProgID não mudam. Este comportamento de nomeação foi concebido para tornar todos os nomes facilmente identificáveis para si à medida que desenvolve o seu controlo.

C++

Fornece informação para a classe C++ criada para implementar o objeto.

• Nome abreviado

  Define o nome abreviado do objeto. O nome que forneces determina os nomes da classe e da Coclasse , o ficheiro (. CPP e . H) nomes, o nome da interface e os nomes dos Tipos , a menos que altere esses campos individualmente.

• Classe

  Define o nome da classe que implementa o objeto. Este nome baseia-se no nome que fornece em Nome Curto, precedido por 'C', o prefixo típico para um nome de classe.

• Arquivo .h

  Define o nome do ficheiro de cabeçalho para a nova classe do objeto. Por defeito, este nome baseia-se no nome que fornece em Nome Curto. Clique no botão de reticência para guardar o nome do ficheiro na localização da sua escolha, ou para anexar a declaração da classe a um ficheiro existente. Se selecionares um ficheiro existente, o assistente não o guardará na localização selecionada até clicares em Terminar.

  O assistente não sobrescreve um ficheiro. Se selecionar o nome de um ficheiro existente, ao clicar em Terminar, o assistente pede-lhe que indique se a declaração de classe deve ser anexada ao conteúdo do ficheiro. Clique em Sim para anexar o ficheiro; clique em Não para voltar ao assistente e especificar outro nome de ficheiro.

• arquivo .cpp

  Define o nome do ficheiro de implementação para a classe do novo objeto. Por defeito, este nome baseia-se no nome que fornece em Nome Curto. Clique no botão de reticência para guardar o nome do ficheiro na localização que escolher. O ficheiro não é guardado na localização selecionada até clicares em Terminar no assistente.

  O assistente não sobrescreve um ficheiro. Se selecionar o nome de um ficheiro existente, ao clicar em Terminar, o assistente pede-lhe para indicar se a implementação da classe deve ser anexada ao conteúdo do ficheiro. Clique em Sim para anexar o ficheiro; clique em Não para voltar ao assistente e especificar outro nome de ficheiro.

• Atribuídos

  Indica se o objeto utiliza atributos. Se estiver a adicionar um objeto a um projeto ATL atribuído, esta opção está selecionada e não está disponível para alteração. Ou seja, pode adicionar apenas objetos atribuídos a um projeto criado com suporte a atributos.

  Podes adicionar um objeto atribuído apenas a um projeto ATL que use atributos. Se selecionares esta opção para um projeto ATL que não tem suporte a atributos, o assistente pede-te para especificar se queres adicionar suporte a atributos ao projeto.

  Por defeito, quaisquer objetos que adiciones depois de definires esta opção são designados como atribuídos (a caixa de seleção está selecionada). Podes limpar esta caixa para adicionar um objeto que não use atributos.

  Consulte Definições de Aplicação, Assistente de Projeto ATL e Mecânicas Básicas dos atributos para mais informações.

COM

Fornece informação sobre a funcionalidade COM do objeto.

• Coclasse

  Define o nome da classe componente que contém uma lista de interfaces suportadas pelo objeto.

  Observação

  Se criares o teu projeto usando atributos, ou se indicares nesta página do assistente que o controlo usa atributos, não podes alterar esta opção porque o ATL não inclui o atributo coclasse .

• Interface

  Define o nome da interface para o objeto. Por defeito, o nome da interface é precedido com "I".

• Type

  Define a descrição do objeto que aparecerá no registo

• ProgID

  Define o nome que os contentores podem usar em vez do CLSID do objeto. Este campo não é preenchido automaticamente. Se não preencher manualmente este campo, o controlo pode não estar disponível para outras ferramentas. Por exemplo, controlos ActiveX gerados sem a ProgID não estão disponíveis na caixa de diálogo Inserir Controlo ActiveX . Para mais informações sobre a caixa de diálogo, veja Inserir controlos ActiveX.

Consulte também

ATL Control
Adição de funcionalidade ao controlo composto
Fundamentos dos ATL COM Objects