Compartilhar via

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

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 para você. 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:

Cuidado

Este conteúdo foi escrito para o .NET Framework. Se você estiver usando o .NET 6 ou uma versão posterior, use esse conteúdo com cuidado. O sistema de design foi alterado para Windows Forms e é importante que você examine o artigo Alterações do Designer desde o .NET Framework.

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.

Observação

A Caixa de Ferramentas exibe apenas componentes de bibliotecas referenciadas diretamente por seu projeto ou componentes definidos por um projeto na solução.

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 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 True.

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.

  2. Na Caixa de Ferramentas, clique na nova guia chamada ToolboxExample Componentes.

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

    Observação

    Por motivos de desempenho, os componentes na área preenchida automaticamente da Caixa de Ferramentas não exibem bitmaps personalizados e o uso de ToolboxBitmapAttribute não é suportado. 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 o componente.

  3. Arraste seu componente para o formulário.

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

Descarregar e recarregar um componente personalizado

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

  1. Desvincule 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 Aplicativo do Windows à solução. Abra o formulário no Designer.

    A aba Componentes ToolboxExample do projeto anterior não existe mais.

  3. Recarregue o ToolboxExample projeto.

    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

  • Last updated on