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

Se seus componentes forem definidos por um projeto na solução atualmente aberta, eles aparecerão automaticamente no Toolbox, sem nenhuma ação exigida por você. Você também pode preencher manualmente a Caixa de Ferramentas com os 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 presentes nos resultados de compilação da sua solução com todas as seguintes características:

• Implementa IComponent;

• Não tem ToolboxItemAttribute definido para false;

• Não tem DesignTimeVisibleAttribute atribuído a false.

Este passo a passo demonstra como um componente personalizado aparece automaticamente no Toolbox depois que o componente é criado. As tarefas ilustradas neste passo a passo incluem:

• Criando um projeto do Windows Forms.

• Criação de um componente personalizado.

• Criando uma instância de um componente personalizado.

• Descarregando e recarregando um componente personalizado.

Quando terminar, você verá que o Toolbox está preenchido 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-lhe DemoComponent.

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

3. Construa o projeto.

4. No menu Ferramentas, clique no item Opções. Clique Geral no item Windows Forms Designer 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 o Toolbox 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 Forms Designer.

2. No Caixa de Ferramentas, clique na nova guia chamada ToolboxExample Components.

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

   Observação

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

3. Arraste o seu componente para o seu formulário.

   Uma instância do componente é criada e adicionada à bandeja de componentes .

Descarregar e recarregar um componente customizado

O Toolbox leva em conta os componentes em cada projeto carregado e, quando um projeto é descarregado, remove referências aos componentes do projeto.

1. Remova o projeto da solução.

   Para obter mais informações sobre como descarregar projetos, consulte Como descarregar e recarregar projetos. Se lhe for pedido para guardar, escolha Sim.

2. Adicione um novo projeto Windows Application à solução. Abra o formulário no Designer.

   O separador ToolboxExample Components do projeto anterior desapareceu.

3. Recarregue o projeto ToolboxExample.

   A guia ToolboxExample Components reaparece agora.

Próximos passos

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

Ver também

• Geral, "Windows Forms Designer", Caixa de diálogo Opções
• Como manipular abas da caixa de ferramentas
• caixa de diálogo Escolher itens da caixa de ferramentas (Visual Studio)
• Colocando controles no Windows Forms