Instruções passo a passo: preenchendo de forma automática a caixa de ferramentas com componentes personalizados

  • Artigo

Se seus componentes forem definidos por um projeto na solução aberta no momento, eles aparecerão automaticamente na Caixa de Ferramentas sem exigir que você execute nenhuma ação. 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 itens nas saídas de build da sua solução com todas as seguintes características:

Observação

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 dos Windows Forms.

  • Criando um componente personalizado.

  • Criando uma instância de um componente personalizado.

  • Descarregando e recarregando um componente personalizado.

Quando tiver terminado, 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 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 certifique-se de que a opção AutoToolboxPopulate esteja 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. Uma vez que a Caixa de Ferramentas automaticamente conta para 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 Componentes de ToolboxExample.

    Ao 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 não é suportado ToolboxBitmapAttribute . 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 seu componente.

  3. Arraste o componente para seu formulário.

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

Descarregar e recarregar um componente personalizado

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

  1. Descarregue o projeto da solução.

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

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

    A guia Componentes de ToolboxExample do projeto anterior agora está ausente.

  3. Recarregue o projeto ToolboxExample.

    A guia Componentes de ToolboxExample agora será exibida novamente.

Próximas etapas

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

Confira também