Compartilhar via

Passo a passo: criar conteúdo WPF no Windows Forms durante o tempo de design

  • Artigo

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

Pré-requisitos

Você precisa do Visual Studio para concluir este passo a passo.

Criar o projeto

Abra o Visual Studio e crie um projeto de Aplicativo Windows Forms (.NET Framework) no Visual Basic ou No Visual C# chamado HostingWpf.

Nota

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

Criar um novo controle WPF

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

Nota

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

Para criar um novo controle WPF:

  1. Em do 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 para a biblioteca de controle, WpfControlLibrary1. O nome do controle padrão é UserControl1.xaml.

    Adicionar o novo controle tem os seguintes efeitos:

    • O arquivo UserControl1.xaml é adicionado.

    • O arquivo UserControl1.xaml.cs (ou UserControl1.xaml.vb) é adicionado. Este arquivo contém o código de fundo para manipuladores de eventos e outras implementações.

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

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

  2. No modo Design, verifique se UserControl1 está selecionado.

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

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

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

    Nota

    Em geral, você deve hospedar conteúdo mais sofisticado do WPF. O controle System.Windows.Controls.TextBox é usado aqui apenas para fins ilustrativos.

  6. Compile o projeto.

Adicionar um controle WPF a um Formulário do Windows

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

Para adicionar um controle WPF a um Formulário do Windows:

  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 controle ElementHost é criado automaticamente no formulário para hospedar o controle WPF.

    • O controle ElementHost é nomeado elementHost1 e, na janela Propriedades, você pode ver que a propriedade Child dele 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

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

Consulte também