IConfigureToolboxItem Interface

Definição

Fornece a capacidade de configurar ToolboxItem objetos dinamicamente adicionando dados adicionais ao dicionário de propriedades do item da caixa de ferramentas. Esses dados são serializados como uma parte permanente do item da caixa de ferramentas.

public interface class IConfigureToolboxItem
public interface class IConfigureToolboxItem
__interface IConfigureToolboxItem
public interface IConfigureToolboxItem
type IConfigureToolboxItem = interface
Public Interface IConfigureToolboxItem

Comentários

Essa interface pode ser implementada em qualquer objeto creatable que não derive de Package . O serviço da caixa de ferramentas chamará o ConfigureToolboxItem método quando um novo item da caixa de ferramentas for adicionado pela primeira vez à caixa de ferramentas.

As implementações desta interface devem ser registradas. O registro consiste nas seguintes etapas:

  1. Registrando um VSPackage específico como fornecer a configuração do item da caixa de ferramentas.

    Na estrutura de pacote gerenciado, esse registro é feito pelo ProvideToolboxItemConfigurationAttribute .

    O exemplo a seguir mostra como o VSPackage MyPackage registra a ToolboxConfig classe como uma implementação de IConfigureToolboxItem :

    
                        [ProvideToolboxItemConfigurationAttribute(typeof(ToolboxConfig))]  
        [GuidAttribute("XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX")]  
        public class MyPackage : MSVSIP.Package {…}  
    
    
  2. Registrando a configuração dinâmica de todos os ToolboxItem objetos por assemblies especificados.

    Na estrutura de pacote gerenciado, os assemblies cujos ToolboxItem objetos são processados por uma implementação do IConfigureToolboxItem são especificados aplicando- ProvideAssemblyFilterAttribute se a essa implementação de IConfigureToolboxItem .

    O exemplo a seguir registra a ToolboxConfig classe como fornecendo suporte à configuração para todos os ToolboxItem objetos em todos os assemblies com o Vsip namespace.

        [ProvideAssemblyFilterAttribute("Vsip.*, Version=*, Culture=*, PublicKeyToken=*")]  
        public sealed class ToolboxConfig : IConfigureToolboxItem {…}  
    

Observação

Esse atributo usa a identificação completa do assembly, incluindo um nome simples, um número de versão, um par de chaves criptográficas e uma cultura com suporte. Para obter mais informações sobre a identificação do assembly, consulte AssemblyName . O caractere "*" em uma especificação é usado como um caractere curinga.

O registro de uma implementação do IConfigureToolboxItem como parte de um VSPackage modifica as configurações do registro em HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\<Version>\ToolboxItemConfiguration e HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\<Version>\CLSID , em que <Version> é a versão do Visual Studio , por exemplo, 8,0.

Observação

O caminho raiz de HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VisualStudio\<Version> pode ser substituído por uma raiz alternativa quando o Shell do Visual Studio é inicializado ou com DefaultRegistryRootAttribute . Para obter mais informações sobre caminhos de raiz alternativos, consulte Opções de linha de comando e DefaultRegistryRootAttribute .

Para obter mais informações sobre o conteúdo dessas entradas de registro, consulte registrando recursos de suporte da caixa de ferramentas.

Notas aos Implementadores

Implemente essa interface quando precisar modificar as características de um controle de caixa de ferramentas dinamicamente, por exemplo, para responder à presença ou à ausência de determinados recursos ou objetos.

Os métodos dessa interface são invocados somente quando a caixa de ferramentas é inicializada.

O Visual Studio ambiente pode precisar criar uma nova instância de implementações de IConfigureToolboxItem a qualquer momento. Certifique-se de que você: -Sempre implementar IConfigureToolboxItem como uma classe pública.

-Nunca implemente IConfigureToolboxItem em uma classe que implemente Package ou IVsPackage .

Métodos

ConfigureToolboxItem(ToolboxItem)

Chamado pelo serviço de caixa de ferramentas para configurar ToolboxItem objetos.

Aplica-se a