Criar um controle WPF Toolbox

Artigo
12/21/2023

O modelo WPF (Windows Presentation Framework) Toolbox Control permite criar controles 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 Toolbox que você pode distribuir para outros usuários.

Criar o controle Toolbox

Criar uma extensão com um controle WPF Toolbox

Crie um projeto VSIX chamado 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 MyToolboxControlde item de controle do WPF Toolbox chamado . 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, vá para Visual C#>Extensibility e selecione WPF Toolbox Control. 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 ProvideToolboxControlAttributeRegistrationAttribute que adiciona o controle à caixa de ferramentas e uma entrada de ativo Microsoft.VisualStudio.ToolboxControl no manifesto VSIX para implantação.

Para criar a interface do usuário de controle

Abra MyToolboxControl.xaml no designer.

O designer mostra um controle que contém um Grid Button controle.
Organize o layout da grade. Quando você seleciona o Grid controle, 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 Grid.Row atributos 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>
```

Renomeando 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 arquivo.

Abra MyToolboxControl.xaml.cs na visualização de código.
Localize a classe e renomeie-a MyToolboxControl para TestControl. (A maneira mais rápida de fazer isso é renomear a classe e, em seguida, selecionar Renomeie no menu de contexto e conclua as etapas. (Para mais informações sobre o Comando Renomear , consulte Renomear refatoração (C#).)
Vá para o ProvideToolboxControl atributo 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 deve ter esta aparência:
```
[ProvideToolboxControl("Test", true)]
public partial class TestControl : UserControl
{
    public TestControl()
    {
        InitializeComponent();
    }
}
```

Compilação, teste e implantação

Quando você 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

Recrie o projeto e inicie a depuração.
Na nova instância do Visual Studio, crie um projeto de aplicativo WPF. Verifique se o Designer XAML está aberto.
Encontre seu controle na Caixa de Ferramentas e arraste-o para a superfície de design.
Comece a depurar o aplicativo 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, vá para Extensões e atualizações de ferramentas>, procure a extensão de 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 extensões de ferramentas>e atualizações no Visual Studio para localizar o controle online e instalá-lo.

Compartilhar via