Assistente de Controle da ATL

Insere em um controle de ATL em um projeto da ATL (ou um projeto do MFC compatível com a ATL). Você pode usar esse assistente para inserir um dos três tipos de controles:

• Controle padrão

• Controle composto

• Controle DHTML

Além disso, você pode especificar um controle mínimo, removendo as interfaces da lista Interfaces, que são fornecidas como padrões para que os controles sejam abertos na maioria dos contêineres. Você pode definir as interfaces que devem ser compatíveis com o controle na página Interfaces do assistente.

Comentários

O script de registro produzido por esse assistente registra seus componentes COM em HKEY_CURRENT_USER, em vez de em HKEY_LOCAL_MACHINE. Para modificar esse comportamento, defina a opção Registrar componente para todos os usuários do Assistente da ATL.

Nomes

Especifique os nomes para o objeto, a interface e as classes a ser adicionados ao seu projeto. Com exceção da caixa Nome curto, todas as outras podem ser alteradas independentemente. Se você alterar o texto para Nome curto, a alteração será refletida nos nomes de todas as outras caixas dessa página. Se você alterar o nome Coclass na seção COM, a alteração será refletida nas caixas Tipo, mas o nome da Interface e ProgID não mudarão. Esse comportamento de nomenclatura foi criado para tornar todos os nomes facilmente identificáveis à medida que você desenvolve seu controle.

Observação

Coclass é editável apenas em controles não atribuídos. Se o seu projeto foi atribuído, você não pode editar Coclass.

C++

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

• Nome curto

  Define o nome abreviado do objeto. O nome que você fornece determina a classe e os nomes Coclass, os nomes de arquivo (.CPP e .H), o nome da interface e os nomes de ipo, a menos que você altere esses campos individualmente.

• Classe

  Define o nome da classe derivada que implementa o objeto. Esse nome é baseado no nome fornecido em Nome curto, precedido por "C", o prefixo típico de um nome de classe.

• Arquivo .h

  Define o nome do arquivo de cabeçalho para a nova classe do objeto. Por padrão, esse nome é baseado no nome que você fornece em Nome curto. Clique no botão de reticências para salvar o nome de arquivo no local de sua escolha, ou para acrescentar a declaração de classe a um arquivo existente. Se você selecionar um arquivo existente, o assistente não o salvará no local selecionado até que você clique em Concluir.

  O assistente não substitui um arquivo. Se você selecionar o nome de um arquivo existente, quando clicar em Concluir, o assistente solicitará que você indique se a declaração de classe deve ser acrescentada ao conteúdo do arquivo. Clique em Sim para acrescentar o arquivo; clique em Não para retornar ao assistente e especificar outro nome de arquivo.

• Arquivo .cpp

  Define o nome do arquivo de implementação para a nova classe do objeto. Por padrão, esse nome é baseado no nome que você fornece em Nome curto. Clique no botão de reticências para salvar o nome de arquivo no local de sua escolha. O arquivo não é salvo no local selecionado até que você clique em Concluir no assistente.

  O assistente não substitui um arquivo. Se você selecionar o nome de um arquivo existente, quando clicar em Concluir, o assistente solicitará que você indique se a implementação de classe deve ser acrescentada ao conteúdo do arquivo. Clique em Sim para acrescentar o arquivo; clique em Não para retornar ao assistente e especificar outro nome de arquivo.

• Atribuído

  Indica se o objeto usa atributos. Se você estiver adicionando um objeto a um projeto ATL atribuído, essa opção será selecionada e não estará disponível para alteração. Ou seja, você pode adicionar somente objetos atribuídos a um projeto criado com suporte a atributos.

  Você pode adicionar um objeto atribuído somente a um projeto da ATL que usa atributos. Se você selecionar essa opção para um projeto ATL que não tenha suporte a atributo, o assistente solicitará que você especifique se deseja adicionar suporte a atributo ao projeto.

  Por padrão, qualquer objeto que você adiciona após definir essa opção é designado como atribuído (a caixa de seleção fica marcada). Você pode desmarcar essa caixa para adicionar um objeto que não usa atributos.

  Confira mais informações em Configurações de aplicativo, Assistente de projeto ATL e Mecânica básica de atributos.

COM

Fornece informações sobre a funcionalidade COM do objeto.

• Coclass

  Define o nome da classe do componente que contém uma lista de interfaces compatíveis com o objeto.

  Observação

  Se você criar seu projeto usando atributos, ou se indicar nessa página do assistente que o controle usa atributos, não poderá alterar essa opção, pois a ATL não inclui o atributo coclass.

• Interface

  Define o nome da interface do objeto. Por padrão, um "I" é incluído no início do nome da interface.

• Tipo

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

• ProgID

  Define o nome que os contêineres podem usar em vez do CLSID do objeto. Este campo não é populado automaticamente. Se você não preencher manualmente esse campo, o controle poderá não estar disponível para outras ferramentas. Por exemplo, os controles ActiveX gerados sem um ProgID não estarão disponíveis na caixa de diálogo Inserir Controle ActiveX. Para obter mais informações sobre a caixa de diálogo, confira Inserir controles ActiveX.

Confira também

Controle da ATL
Adicionando funcionalidade ao controle de composição
Princípios básicos de objetos COM da ATL