Compartilhar via


Opções, Assistente de controle da ATL

Use esta página do assistente para definir o tipo de controle que você está criando e o nível de suporte de interface que ele contém.

Lista de elementos de interface do usuário

Tipo de controle

O tipo de controle que você deseja criar.

  • Controle padrão: um controle ActiveX.

  • Controle composto: um controle ActiveX que pode conter (semelhante a uma caixa de diálogo) outros controles ActiveX ou controles do Windows. Um controle composto inclui o seguinte:

    • Um modelo para a caixa de diálogo que implementa o controle composto.

    • Um recurso personalizado, REGISTRY, que registra automaticamente o controle composto quando invocado.

    • Uma classe C++ que implementa o controle composto.

    • Uma interface COM, exposta pelo controle composto.

    • Uma página de teste HTML que contém o controle composto.

      Por padrão, esse controle define CComControlBase::m_bWindowOnly como true, para indicar que esse é um controle com janelas. Ele implementa um mapa do coletor. Para obter mais informações, consulte Suporte para controle DHTML.

  • Controle DHTML: um controle DHTML da ATL especifica a interface do usuário, usando HTML. A classe de interface do usuário DHTML contém um mapa COM. Por padrão, esse controle define CComControlBase::m_bWindowOnly como true, para indicar que esse é um controle com janelas.

    Para obter mais informações, confira Identificando os elementos do projeto de controle DHTML.

Controle mínimo

Dá suporte apenas às interfaces que são absolutamente necessárias para a maioria dos contêineres. Você pode definir o controle mínimo para qualquer um dos tipos de controle: você pode criar um controle padrão mínimo, um controle composto mínimo ou um controle DHTML mínimo.

Agregação

Adiciona suporte de agregação para o controle que você está criando. Para mais informações, confira Agregação.

  • Sim: crie um controle que possa ser agregado.

  • Não: crie um controle que não possa ser agregado.

  • Apenas: crie um controle que só pode ser instanciado por meio de uma agregação.

Modelo de threading

Especifica o modelo de threading usado pelo controle.

  • Único: o controle será executado somente no thread COM primário.

  • Apartamento: o controle pode ser criado em qualquer apartament de thread. O padrão.

Interface

O tipo de interface que esse controle expõe ao contêiner.

  • Duplo: cria uma interface que expõe propriedades e métodos por meio de IDispatch e diretamente por meio do VTBL.

  • Personalizado: cria uma interface que expõe métodos diretamente por meio de um VTBL.

    Se você selecionar Personalizado, poderá especificar que o controle é compatível com a Automação. Se você selecionar compatível com a Automação, o assistente adicionará o atributo oleautomation à interface na IDL e a interface poderá realizar marshal pelo marshaler universal em oleaut32.dll. Consulte Detalhes de marshaling no SDK do Windows para obter mais informações.

    Além disso, se você selecionar compatível com a Automação, todos os parâmetros para todos os métodos no controle deverão ser compatíveis com VARIANT.

Suporte

Define suporte diverso adicional para o controle.

  • Pontos de conexão: habilita pontos de conexão para seu objeto fazendo com que a classe do objeto seja derivada de IConnectionPointContainerImpl e permitindo que ele exponha uma interface de origem.

  • Licenciado: adiciona suporte ao controle para licenciamento. Os controles licenciados só poderão ser hospedados se o computador cliente tiver a licença correta.

Confira também

Assistente de Controle da ATL