Compartilhar via

Passo a passo: preencher automaticamente a caixa de ferramentas com componentes personalizados

  • Artigo

Se os componentes forem definidos por um projeto na solução aberta no momento, eles aparecerão automaticamente na caixa de ferramentas , sem nenhuma ação necessária da sua parte. Você também pode preencher manualmente a caixa de ferramentas com seus componentes personalizados usando a caixa de diálogo Escolher Itens da Caixa de Ferramentas (Visual Studio), mas a caixa de ferramentas leva em conta os itens nas saídas de build da sua solução com todas as seguintes características:

Nota

A caixa de ferramentas não segue cadeias de referência, portanto, não exibirá itens que não são criados por um projeto em sua solução.

Este passo a passo demonstra como um componente personalizado aparece automaticamente na caixa de ferramentas depois que o componente é criado. As tarefas ilustradas neste passo a passo incluem:

  • Criando um projeto do Windows Forms.

  • Criando um componente personalizado.

  • Criando uma instância de um componente personalizado.

  • Descarregando e recarregando um componente personalizado.

Quando terminar, você verá que a caixa de ferramentas é preenchida com um componente que você criou.

Criar o projeto

  1. No Visual Studio, crie um projeto de aplicativo baseado no Windows chamado ToolboxExample (File>New>Project>Visual C# ou Visual Basic>Classic Desktop>Windows Forms Application).

  2. Adicione um novo componente ao projeto. Chame-o de DemoComponent.

    Para obter mais informações, consulte Como adicionar novos itens de projeto.

  3. Compile o projeto.

  4. No menu ferramentas, clique no item opções. Clique em Geral no item Designer de Formulários do Windows e verifique se a opção AutoToolboxPopulate está definida como Verdadeiro.

Criar uma instância de um componente personalizado

A próxima etapa é criar uma instância do componente personalizado no formulário. Como a caixa de ferramentas contabiliza automaticamente o novo componente, isso é tão fácil quanto criar qualquer outro componente ou controle.

  1. Abra o formulário do projeto no Designer de Formulários do.

  2. Na caixa de ferramentas , clique na nova guia chamada ComponentesToolboxExample.

    Depois de clicar na guia, você verá DemoComponent.

    Nota

    Por motivos de desempenho, os componentes na área preenchida automaticamente da caixa de ferramentas não exibem bitmaps personalizados e não há suporte para o ToolboxBitmapAttribute. Para exibir um ícone de um componente personalizado na caixa de ferramentas, use a caixa de diálogo Escolher Itens da Caixa de Ferramentas para carregar seu componente.

  3. Arraste seu componente para seu formulário.

    Uma instância do componente é criada e adicionada aoda Bandeja de Componentes do .

Descarregar e recarregar um componente personalizado

A caixa de ferramentas leva em conta os componentes em cada projeto carregado e, quando um projeto é descarregado, ele remove referências aos componentes do projeto.

  1. Remova o projeto da solução.

    Para obter mais informações sobre o descarregamento de projetos, consulte Como descarregar e recarregar projetos. Se for solicitado que você salve, escolha Sim.

  2. Adicione um novo projeto de aplicação do Windows à solução. Abra o formulário no designer.

    A aba Componentes ToolboxExample do projeto anterior não está mais disponível.

  3. Recarregue o projeto ToolboxExample.

    A guia componentes ToolboxExample agora reaparece.

Próximas etapas

Este passo a passo demonstra que a caixa de ferramentas leva em conta os componentes de um projeto, mas a caixa de ferramentas também leva em conta os controles. Experimente seus próprios controles personalizados adicionando e removendo projetos de controle de sua solução.

Consulte também