Compartilhar via


Como: criar um controle de caixa de ferramentas que usa o Windows Forms

O modelo de controle de caixa de ferramentas do Windows Forms que está incluído no SDL do Visual Studio 2010 permite que você crie controles Windows Forms que são adicionados automaticamente para o caixa de ferramentas quando a extensão está instalada. Este tópico mostra como usar o modelo para criar um caixa de ferramentas o controle que você pode distribuir para outros usuários. Uma implementação completa de um caixa de ferramentas controle, consulte Passo a passo: Criando um controle de caixa de ferramentas do Windows Forms.

Dica

Para obter mais informações sobre o SDK de Visual Studio, consulte Ampliando a visão geral de Visual Studio.Para descobrir como fazer o download do SDK do Visual Studio, consulte Visual Studio extensibilidade Developer Center no site do MSDN.

Criar um controle de caixa de ferramentas

Use o modelo de controle de caixa de ferramentas do Windows Forms para criar o projeto e, em seguida, crie uma interface de usuário (UI) no designer.

Para criar um projeto de controle de caixa de ferramentas do Windows Forms

  1. No menu File, clique em New, e em seguida, clique em Project

  2. No Novo projeto caixa de diálogo, em Modelos instalados, clique no nó para sua linguagem de programação preferida e, em seguida, clique em extensibilidade. Na lista de tipos de projeto, selecione Caixa de ferramentas de controle do Windows Forms.

  3. No nome , digite o nome que você deseja usar para o projeto. Clique em OK.

    Visual Studio cria uma solução que contém um controle de usuário, um atributo para colocar o controle caixa de ferramentas, e um VSIX de manifesto de implantação.

Para criar o controle da interface do usuário

  1. Em Solution Explorer, clique duas vezes em ToolboxControl.cs para abri-lo no designer.

  2. Do caixa de ferramentas, arraste os controles que você deseja para a superfície de design e organizá-las de acordo com a sua estrutura.

  3. No Propriedades janela, defina propriedades públicas sobre o controle de usuário e no filho controles.

Codificar o controle

Por padrão, o controle será exibido na caixa de ferramentas como ToolboxControl1 em um Toolbox grupo de item que tem o mesmo nome de sua solução. Você pode alterar esses nomes no arquivo ToolboxControl.cs.

O controle de código

  1. Em Solution Explorer, ToolboxControl.cs com o botão direito e, em seguida, clique em Exibir código para abrir o arquivo no modo de exibição de código.

  2. A definição da classe parcial que implementa o controle, clique com o botão direito no nome de classe, clique em Refactore, em seguida, clique em Renomear. Altere o nome da classe para o nome que você deseja exibir na caixa de ferramentas quando o controle está instalado.

  3. Imediatamente acima da definição de classe, no ProvideToolboxControl a declaração de atributo, altere o valor do primeiro parâmetro para o nome do grupo de itens que irá hospedar o controle no caixa de ferramentas.

    A exemplo a seguir mostra a ProvideToolboxControl atributo e a definição de classe ajustado para um controle chamado contador na Geral grupo de itens.

    [ProvideToolboxControl("General", false)]
    public partial class Counter : UserControl
    
  4. Implemente as propriedades, métodos e eventos para o controle.

Criação, teste e implantação

Pressionando F5 constrói o projeto, que inclui um arquivo de implantação de .vsix e abre uma segunda instância do Visual Studio que tem o controle instalado no caixa de ferramentas.

Para criar e testar o controle

  1. Pressione F5.

  2. Na nova instância de Visual Studio, crie um projeto de aplicativo do Windows Forms.

  3. Localizar seu controle no caixa de ferramentas e arraste-o para a superfície de design.

  4. No Propriedades janela, verifique se as propriedades aparecem como esperado.

  5. Adicione qualquer código ou controles adicionais que são necessárias para testar seus métodos e eventos.

  6. Pressione F5 para abrir o aplicativo Windows Forms.

  7. Verifique se as propriedades, métodos e eventos do seu controle se comportar conforme o esperado.

Para implantar o controle

  1. Depois de criar o projeto testado, abra a pasta de \bin\debug\ do projeto no Windows Explorer e localize o arquivo .vsix.

  2. Carregue o arquivo de .vsix a uma rede ou um site da Web.

    Se você carregar o arquivo para o Galeria de Visual Studio site da Web, outros usuários podem usar Extension Manager em Visual Studio para localizar o controle e instalá-lo.

Consulte também

Tarefas

Passo a passo: Criando um controle de caixa de ferramentas do Windows Forms

Como: criar um controle de caixa de ferramentas que utiliza WPF

Outros recursos

A caixa de ferramentas (Visual Studio SDK)