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

Artigo
05/18/2015

O modelo de controle de caixa de ferramentas do WPF que está incluído no SDL do Visual Studio 2010 permite que você crie controles de Windows Presentation Foundation (WPF) 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. Para uma implementação completa de um controle de caixa de ferramentas do WPF, consulte Passo a passo: Criando um controle de caixa de ferramentas do WPF.

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 WPF para criar o projeto e, em seguida, crie uma interface de usuário (UI) no designer XAML Extensible Application Markup Language ().

Para criar um projeto de controle de caixa de ferramentas do WPF

No menu File, clique em New, e em seguida, clique em Project
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 O controle de caixa de ferramentas do WPF.
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

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

O designer mostra uma Grid controle que contém um Button controle.
Organize o layout de grade.

Quando você seleciona o Grid controlar, barras de controle azuis aparecem nas bordas superior e esquerdas da grade. Você pode adicionar linhas e colunas para a grade clicando nas barras.
Adicione controles filho para a grade.

Você pode posicionar um controle filho, arrastando-a partir de Toolbox a uma seção da grade, ou definindo seu Grid.Row e Grid.Column atributos no XAML. O exemplo seguinte posiciona dois rótulos na linha superior de uma grade e posiciona um botão na segunda linha.
```
<Button Content="Reset" Name="button1" Click="button1_Click" Grid.Row="1" Grid.ColumnSpan="2" />
<Label Content="{Binding Text}" Grid.Row="0" Grid.Column="0" Name="label1" />
<Label Content="{Binding Count}" Grid.Row="0" Grid.Column="1" Name="label2" />
```

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.xaml.cs.

O controle de código

Em Solution Explorer, ToolboxControl.xaml.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.
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.
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", true)]
public partial class Counter : UserControl
```
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

Pressione F5.
Na nova instância de Visual Studio, crie um projeto de aplicativo do WPF.
Localizar seu controle no caixa de ferramentas e arraste-o para a superfície de design.
No Propriedades janela, verifique se as propriedades aparecem como esperado.
Adicione qualquer código ou controles adicionais que são necessárias para testar seus métodos e eventos.
Pressione F5 para abrir o aplicativo do WPF.
Verifique se as propriedades, métodos e eventos do seu controle se comportar conforme o esperado.

Para implantar o controle

Depois de criar o projeto testado, abra a pasta de \bin\debug\ do projeto no Windows Explorer e localize o arquivo .vsix.
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 WPF

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

Outros recursos

A caixa de ferramentas (Visual Studio SDK)

Compartilhar via