Assistente de Objetos Simples ATL

Este assistente insere no projeto um objeto COM mínimo. Use esta página do assistente para especificar os nomes que identificam a classe C++ e os ficheiros do seu objeto e da sua funcionalidade COM.

Use a página de Opções deste assistente para especificar o modelo de threading do objeto, o seu suporte à agregação e se suporta interfaces duplas e Automação. Também pode indicar suporte para a interface de informação de erro, pontos de ligação, suporte ao Internet Explorer e marshaling free-threaded.

Observações

A partir do Visual Studio 2008, 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 editadas independentemente das outras. 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 nas caixas Tipo e ProgID , mas o nome da Interface não muda. 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 o objeto.

• Nome abreviado

  Define o nome abreviado do objeto. O nome que forneces determina os Class nomes e, Coclass os nomes dos ficheiros .cpp e .h , o nome da Interface , os nomes dos Tipos e o ProgID, a menos que alteres esses campos individualmente.

• 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 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 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.

• Classe

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

• 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 criar o seu projeto usando atributos, ou se indicar nesta página do assistente que o objeto usa atributos, não pode alterar esta opção porque o ATL não inclui o coclass atributo.

• Type

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

• Interface

  Define a interface que crias para o teu objeto. Esta interface contém os seus métodos personalizados.

• ProgID

  Define o nome que os contentores podem usar em vez do CLSID do objeto.

Consulte também

ATL Simple Object