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

Este tópico mostra como criar um controle Windows Presentation Foundation (WPF) para uso em aplicativos baseados em Formulários do Windows.

Nesta explicação passo a passo, você executa as seguintes tarefas:

  • Criar o projeto.

  • Criar um novo controle WPF.

  • Adicionar o novo controle WPF a um Formulário do Windows. O controle WPF é hospedado em um controle ElementHost.

ObservaçãoObservação

As caixas de diálogo e comandos de menu demonstradas podem ser diferentes daqueles descritos na Ajuda, dependendo das configurações ativas ou configurações de edição. Para alterar as configurações, escolha Import and Export Settings sobre o Ferramentas menu. Para obter mais informações, consulte Trabalhando com configurações.

Pré-requisitos

Para completar este passo a passo, são necessários os seguintes componentes:

  • Visual Studio 2008.

Criando o projeto

A primeira etapa é criar um projeto de Formulário Windows.

ObservaçãoObservação

Quando hospedar conteúdo WPF, apenas projetos C# e Visual Basic são suportados.

Para criar o projeto

Criando 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 Windows Forms Designer funciona com um determinado tipo de controle chamado controle composto, ou controle do usuário. Para obter mais informações sobre controles de usuário WPF, consulte UserControl.

ObservaçãoObservação

O tipo System.Windows.Controls.UserControl de WPF é distinto do tipo controle de usuário fornecido pelos Formulários do Windows, que também é chamado System.Windows.Forms.UserControl.

Para criar um novo controle WPF.

  1. Em Solution Explorer, adicionar um novo Biblioteca de controle de usuário do WPF o projeto à solução. Use o nome padrão para a biblioteca de controle, WpfControlLibrary1. O nome de controle padrão é UserControl1.xaml.

    Adicionar o novo controle tem os seguintes efeitos.

    • UserControl1.xaml de arquivo é 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 aos assemblies do WPF são adicionadas.

    • UserControl1.xaml é aberto no WPF Designer for Visual Studio.

  2. No modo de exibição de design, veja se UserControl1 está selecionada. Para obter mais informações, consulte Como: Selecionar e mover elementos na superfície de design.

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

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

  5. No Propriedades janela, defina o valor da Text propriedade para conteúdo de hospedado.

    ObservaçãoObservação

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

  6. Crie o projeto.

Adicionando um controle WPF a um Formulário do Windows

O novo controle WPF estará pronto para uso no formulário. Os Formulários do Windows usam o controle ElementHost para hospedar conteúdo WPF

Para Adicionar um controle WPF a um Formulário do Windows

  1. Abra Form1 no Windows Forms Designer.

  2. No caixa de ferramentas, encontrar a guia Controles de usuário do WPF WPFUserControlLibrary.

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

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

    • O controle ElementHost é chamado elementHost1 e na janela Propriedades, você poderá ver que sua propriedade Child é definida como UserControl1.

    • Referências para módulos (assemblies) WPF são adicionadas ao projeto.

    • O controle elementHost1 possui um painel de marcas inteligentes que mostra as opções disponíveis de hospedagem.

  4. No painel de marcas inteligentes Tarefas ElementHost, selecione Encaixar no recipiente pai.

  5. Pressione F5 para criar e executar o aplicativo.

Próximas etapas

Formulários do Windows e WPF são tecnologias diferentes, mas eles são criados para interoperar de perto. Para fornecer aparência e comportamento mais ricos aos seus aplicativos, tente o seguinte.

Consulte também

Referência

ElementHost

WindowsFormsHost

Outros recursos

Migração e Interoperabilidade

Usando os controles do WPF

WPF Designer