Criar um controle da Caixa de Ferramentas do WPF

Artigo
07/12/2024

O modelo Controle da Caixa de Ferramentas do WPF (Windows Presentation Framework) permite criar controles do WPF que são adicionados automaticamente à Caixa de Ferramentas quando a extensão é instalada. Este passo a passo mostra como usar o modelo para criar um controle da Caixa de Ferramentas que você pode distribuir para outros usuários.

Criar o Controle da Caixa de Ferramentas

Criar uma extensão com um Controle da Caixa de Ferramentas do WPF

Criar um projeto VSIC com o nome de MyToolboxControl. Você pode encontrar o modelo de projeto VSIX na caixa de diálogo Novo Projeto pesquisando por "vsix".
Quando o projeto for aberto, adicione um modelo de item Controle da Caixa de Ferramentas do WPF chamado MyToolboxControl. No Gerenciador de Soluções, clique com o botão direito do mouse no nó do projeto e selecione Adicionar>Novo Item. Na caixa de diálogo Adicionar Novo Item, acesse Visual C#>Extensibility e selecione Controle da Caixa de Ferramentas do WPF. No campo Nome na parte inferior da janela, altere o nome do arquivo de comando para MyToolboxControl.cs.

A solução agora contém um controle de usuário, um ProvideToolboxControlAttribute RegistrationAttribute que adiciona o controle à Caixa de Ferramentas e uma entrada de ativo Microsoft.VisualStudio.ToolboxControl no manifesto do VSIX para implantação.

Para criar a interface do usuário do controle

Abra MyToolboxControl.xaml no designer.

O designer mostra um controle Grid que contém um controle Button.
Organize o layout da grade. Quando você seleciona o controle Grid, barras de controle azuis aparecem nas bordas superior e esquerda da grade. Você pode adicionar linhas e colunas à grade clicando nas barras.
Adicione controles filho à grade. Você pode posicionar um controle filho arrastando-o da Caixa de Ferramentas para uma seção da grade ou definindo seus atributos Grid.Row e Grid.Column no XAML. O exemplo a seguir adiciona dois rótulos na linha superior da grade e um botão na segunda linha.
```
<Grid>
    <Label Grid.Row="0" Grid.Column="0" Name="label1" />
    <Label Grid.Row="0" Grid.Column="1" Name="label2" />
    <Button Name="button1" Click="button1_Click" Grid.Row="1" Grid.ColumnSpan="2" />
</Grid>
```

Renomear o controle

Por padrão, seu controle aparecerá na Caixa de Ferramentas como MyToolboxControl em um grupo chamado MyToolboxControl.MyToolboxControl. Você pode alterar esses nomes no arquivo MyToolboxControl.xaml.cs.

Abra MyToolboxControl.xaml.cs na visualização de código.
Localize a classe MyToolboxControl e renomeie-a para TestControl. (A maneira mais rápida de fazer isso é renomear a classe e selecionar Renomear no menu de contexto e concluir as etapas. (Para obter mais informações sobre o comando Renomear, consulte Renomear refatoração (C#).)
Vá para o atributo ProvideToolboxControl e altere o valor do primeiro parâmetro para Test. Esse é o nome do grupo que conterá o controle na Caixa de Ferramentas.

O código resultante ficará assim:
```
[ProvideToolboxControl("Test", true)]
public partial class TestControl : UserControl
{
    public TestControl()
    {
        InitializeComponent();
    }
}
```

Compilar, testar e implantar

Ao depurar o projeto, você deve encontrar o controle instalado na Caixa de Ferramentas da instância experimental do Visual Studio.

Para criar e testar o controle

Compile o projeto novamente e inicie a depuração.
Na nova instância do Visual Studio, crie um projeto de aplicativo do WPF. Verifique se o Designer XAML está aberto.
Localize seu controle na Caixa de Ferramentas e arraste-o até a superfície de design.
Inicie a depuração do aplicativo do WPF.
Verifique se o controle é exibido.

Para implantar o controle

Depois de compilar o projeto testado, você pode encontrar o arquivo .vsix na pasta *\bin\debug* do projeto.
Você pode instalá-lo em um computador local clicando duas vezes no arquivo .vsix e seguindo o procedimento de instalação. Para desinstalar o controle, acesse Extensões e Atualizações> de Ferramentas, procure a extensão do controle e clique em Desinstalar.
Carregue o arquivo .vsix em uma rede ou em um site.

Se você carregar o arquivo no site do Visual Studio Marketplace, outros usuários poderão usar Ferramentas>Extensões e Atualizações no Visual Studio para localizar o controle online e instalá-lo.

Partilhar via