Informações de registo dos controlos ActiveX

Há uma série de entradas de registro e sinalizadores que são usados. Além disso, os controles podem oferecer suporte a categorias de componentes para classificar os recursos que eles fornecem.

As chaves do Registro relacionadas aos controles são marcadas com um asterisco na árvore a seguir:

HKEY_CLASSES_ROOT
   CLSID
      {control_CLSID}
         ProgID = <identifier>
         InprocServer32 = <filename>.dll
         *DefaultIcon = <filename>.<ext>,resourceID
         *ToolboxBitmap32 = <filename>.<ext>,resourceID
         *Control
         verb
            *n = &Properties...
         *MiscStatus = 0
         TypeLib = {object_typelibID}
         *Version = version_number

A entrada DefaultIcon é usada para identificar um ícone a ser exibido quando o controle é minimizado para um ícone. A função ExtractIcon é usada para obter o ícone do arquivo .DLL ou .EXE especificado.

A entrada ToolboxBitmap32 identifica o nome do módulo e o identificador de recurso para um bitmap 16 * 15 a ser usado para a face de uma barra de ferramentas ou botão da caixa de ferramentas. O tamanho padrão do ícone do Windows é muito grande para ser usado para essa finalidade. Esta entrada suporta especificamente recipientes de controle que têm um modo de design no qual se seleciona controles e os coloca em um formulário que está sendo projetado. Por exemplo, no Visual Basic, o ícone do controle é exibido na caixa de ferramentas do Visual Basic durante o modo de design.

A entrada Control marca um objeto como um controle. Esta entrada é frequentemente usada por contêineres para preencher caixas de diálogo. O contêiner usa essa subchave para determinar se um objeto deve ser incluído em uma caixa de diálogo que exibe controles.

A subchave Insertable também pode ser usada com controles, dependendo se o objeto pode atuar apenas como um objeto incorporado in-loco sem recursos especiais de controle. Os objetos marcados com Inserível aparecem na caixa de diálogo Inserir Objeto de seu contêiner. A entrada Insertable geralmente significa que o controle foi testado com recipientes sem controle.

As subchaves Insertable e Control são opcionais. Um controle pode omitir a subchave Insertable se não tiver sido projetado para funcionar com contêineres mais antigos que não entendem os controles. Um controle pode omitir a chave Control se for projetado apenas para trabalhar com um contêiner específico e, portanto, não desejar ser inserido em outros contêineres.

Os controles devem ter um Propertiesverb, OLEIVERB_PROPERTIES, juntamente com quaisquer outros verbos que eles suportam. O Propertiesverb, bem como o OLEIVERB_PRIMARY padrão verb , instrui o controle a exibir sua folha de propriedades. O Propertiesverb é exibido como o Properties item no menu do contêiner quando o controle está ativo. Dessa forma, o controle pode exibir sua própria página de propriedades, permitindo alguma funcionalidade útil para o usuário final, mesmo que o contêiner não manipule controles.

Um controle define a MiscStatus chave para descrever-se a contêineres potenciais. Os bits assumem os valores de OLEMISCe os controles adicionam vários valores a essa enumeração. Consulte os OLEMISC valores de enumeração para obter mais informações. O cliente pode obter essas informações chamando IOleObject::GetMiscStatus sem ter que instanciar o controle primeiro.

Finalmente, versão descreve a versão do controle que deve corresponder à versão da biblioteca de tipos associada a esse controle.

Também nas informações de tipo para um controle, o controle de atributo marca uma entrada de coclasse como descrevendo um controle.