Compartilhar via

Demonstra Passo a passo: Criar novo conteúdo WPF no Windows Forms em tempo de design

  • Artigo

Este artigo mostra como criar um controle Windows Presentation Foundation (WPF) para uso em seus aplicativos baseados no Windows Forms.

Pré-requisitos

É necessário o Visual Studio para concluir este passo a passo.

Criar o projeto

Abra o Visual Studio e crie um novo projeto do Windows Forms App (.NET Framework) no Visual Basic ou Visual C# chamado HostingWpf.

Observação

Ao hospedar conteúdo do WPF, haverá suporte apenas para projetos em C# e Visual Basic.

Criar um novo controle WPF

Criar um novo controle WPF e adicioná-lo ao projeto é tão fácil quanto adicionar qualquer outro item ao projeto. O Designer de Formulários do Windows funciona com um determinado tipo de controle, chamado controle de composição ou controle de usuário. Para obter mais informações sobre controles de usuário do WPF, consulte UserControl.

Observação

O System.Windows.Controls.UserControl tipo para WPF é diferente do tipo de controle de usuário fornecido pelo Windows Forms, que também é chamado System.Windows.Forms.UserControl.

Para criar um novo controle WPF:

  1. No Gerenciador de Soluções, adicione um novo projeto da Biblioteca de Controle de Usuário do WPF (.NET Framework) à solução. Use o nome padrão da biblioteca de controle, WpfControlLibrary1. O nome de controle padrão é UserControl1.xaml.

    Adicionar o novo controle tem os seguintes efeitos:

    • O arquivo UserControl1.xaml será adicionado.

    • O arquivo UserControl1.xaml.cs (ou UserControl1.xaml.vb) é adicionado. Este arquivo contém o code-behind para manipuladores de eventos e outras implementações.

    • Referências a assemblies WPF serão adicionadas.

    • O arquivo UserControl1.xaml é aberto no WPF Designer para Visual Studio.

  2. No modo de exibição de Design, verifique se UserControl1 está selecionado.

  3. Na janela Propriedades, defina o valor das Width propriedades e Height como 200.

  4. Na Caixa de Ferramentas, arraste um System.Windows.Controls.TextBox controle para a superfície de design.

  5. Na janela Propriedades, defina o Text valor da propriedade como Conteúdo Hospedado.

    Observação

    No geral, é necessário hospedar conteúdos do WPF mais sofisticados. O System.Windows.Controls.TextBox controle é usado aqui apenas para fins ilustrativos.

  6. Compile o projeto.

Adicionar um controle WPF a um Windows Form

O novo controle WPF está pronto para uso no formulário. O Windows Forms usa o ElementHost controle para hospedar conteúdo WPF.

Para adicionar um controle WPF a um Windows Form:

  1. Abra Form1 no Designer de Formulários do Windows.

  2. Na Caixa de Ferramentas, localize a guia com o rótulo Controles de Usuário WPF WPFUserControlLibrary.

  3. Arraste uma instância de UserControl1 para o formulário.

    • Um ElementHost controle é criado automaticamente no formulário para hospedar o controle WPF.

    • O ElementHost controle é nomeado elementHost1 e, na janela Propriedades , você pode ver sua Child propriedade está definida como UserControl1.

    • Referências a assemblies WPF serão adicionadas ao projeto.

    • O controle elementHost1 tem um painel de smart tag que mostra as opções de hospedagem disponíveis.

  4. No painel de smart tag ElementHost Tasks, selecione Encaixar no Contêiner Pai.

  5. Pressione F5 para compilar e executar o aplicativo.

Próximas etapas

O Windows Forms e o WPF são tecnologias diferentes, mas são projetados para interoperar estreitamente. Para fornecer aparência e comportamento mais avançados em seus aplicativos, tente o seguinte:

Confira também