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

Se seus componentes são definidos por um projeto na solução aberta no momento, eles aparecerão automaticamente na caixa de ferramentas, com nenhuma ação é necessária por você. Também manualmente, você pode preencher o caixa de ferramentas com os componentes personalizados usando o Escolha a caixa de diálogo de itens da caixa de ferramentas (Visual Studio), mas o Toolbox leva em conta itens em saídas de compilação da solução com as seguintes características:

• Implementa IComponent;

• Não tem ToolboxItemAttribute definido como false;

• Não tem DesignTimeVisibleAttribute definido como false.

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

Esta explicação 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 a um componente personalizado.

Quando tiver terminado, você verá que o caixa de ferramentas é preenchida com um componente que você criou.

Observação
As caixas de diálogo e comandos de menu demonstradas podem ser diferentes daqueles descritos na Ajuda, dependendo das configurações ativas ou configurações de edição. Para alterar as configurações, escolha Import and Export Settings sobre o Ferramentas menu. Para obter mais informações, consulte Trabalhando com configurações.

Criando o projeto

A primeira etapa é criar o projeto e configurar o formulário.

Para criar o projeto

1. Crie um projeto de aplicativo do Windows chamado ToolboxExample.

   Para obter mais informações, consulte Como: Crie um novo projeto de aplicativo do Windows Forms.

2. Adicione um novo componente ao projeto. Chamá-la DemoComponent.

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

3. Crie o projeto.

4. Do Ferramentas menu, clique no Opções item. Clique em Geral sob o Windows Forms Designer item e garantir que o AutoToolboxPopulate opção é definida como True.

Criando uma instância de um componente personalizado

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

Para criar uma instância de um componente personalizado

1. Abra o formulário do projeto no Forms Designer.

2. No caixa de ferramentas, clique na guia novo chamada Componentes de ToolboxExample.

   Quando você clicar na guia, você verá DemoComponent.

   Observação
   Por motivos de desempenho, componentes na área de preenchido automaticamente o caixa de ferramentas não exibir bitmaps personalizados e o ToolboxBitmapAttribute não é suportado. Para exibir um ícone para um componente personalizado na Toolbox, use o Choose Toolbox Items caixa de diálogo carregar seu componente.

3. Arraste o componente para seu formulário.

   Uma instância do componente é criada e adicionada para o Component Tray.

Descarregando e recarregando a um componente personalizado

O caixa de ferramentas leva a conta dos componentes em cada projeto de carregado e quando um projeto é descarregado, ele remove referências a componentes do projeto.

Para experimentar o efeito na caixa de ferramentas de descarregar e recarregar os componentes

1. Descarrega o projeto da solução.

   Para obter mais informações sobre o descarregamento de projetos, consulte Como: Descarregar e recarregar projetos. Se você for solicitado a salvar, escolha Sim.

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

   O ToolboxExample componentes agora o guia do projeto anterior é removida.

3. Recarregar o ToolboxExample project.

   O Componentes de ToolboxExample guia agora reaparece.

Próximas etapas

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

Consulte também

Tarefas

Como: Manipular guias da caixa de ferramentas

Referência

Geral, Windows Forms Designer, Opções da Caixa de Diálogo

Escolha a caixa de diálogo de itens da caixa de ferramentas (Visual Studio)

Outros recursos

Colocar controles em formulários do Windows