Usando controles do WPF em soluções Office

  • Artigo

Windows Presentation Foundation (WPF) é uma alternativa ao Windows Forms para criar interfaces do usuário.WPF usa uma linguagem de marcação chamada XAML (Extensible Aplicativo Markup Idioma) para fornecer Novo técnicas de incorporação da interface do usuário, mídia e documentos.For more information, see Introdução ao Windows Presentation Foundation.

Embora as soluções de Ferramentas do Visual Studio para o Office tenham sido projetadas para trabalhar com controles Windows Forms, você também pode usar controles do WPF em suas soluções.Qualquer elemento de interface do usuário que pode Host Windows Forms controles em uma possível solução de Ferramentas do Visual Studio para o Office também controles do WPF Host.Esses Incluir os seguintes elementos:

  • Os documentos e planilhas em personalizações em nível de documento.

  • Painéis de ações em personalizações em nível de documento.

  • Painéis de tarefas Personalizars em nível de aplicativo Adicionar-ins.

  • Formam regiões no nível de aplicativo Adicionar-ins para o Outlook.

Adicionando controles WPF para o Visual Studio Tools para projetos do Office em tempo de design

Você não pode adicionar controles do WPF diretamente ao elementos de interface do usuário em soluções de Ferramentas do Visual Studio para o Office.Em vez disso, adicionar um item de controle de usuário (WPF) ao seu projeto e usá-la como a superfície de design para controles do WPF.Em seguida, Adicionar o Controlarar do usuário WPF para um elemento de interface do usuário em seu projeto.

Para adicionar o WPF controles a um painel de ações, o painel de tarefas Personalizar ou a região de formulário

  1. Abrir um projeto ao qual você deseja adicionar um painel de tarefas Personalizar, um painel de ações ou uma região de formulário.

  2. Adicionar um item de De Controlarar de usuário (WPF) para seu projeto.

  3. Da De caixa de ferramentas, adicionar controles do WPF ao controle de usuário WPF Design superfície.

    Por padrão, quando o designer de controle de usuário do WPF é Abrir, a caixa de ferramentas contém apenas os controles do WPF.

  4. Crie o projeto.

  5. Adicionar um painel de ações, a região de formulário ou o painel de tarefas Personalizar ao seu projeto:

  6. Na ProjectNameControles de usuário do WPF guia de De caixa de ferramentas, arraste o controle de usuário do WPF para o designer para o painel de ações, a região de formulário ou o painel de tarefas Personalizar.

    O Visual Studio cria automaticamente um objeto de ElementHost que hospeda o Controlarar de usuário do WPF no elemento da interface do usuário.

  7. Crie o projeto.

Para adicionar controles do WPF a um documento ou planilha em um projeto de nível de documento

  1. Abrir um projeto de nível de documento para Word ou Excel.

  2. Adicionar um item de De Controlarar de usuário (WPF) para seu projeto.

  3. Da De caixa de ferramentas, adicionar controles do WPF ao controle de usuário WPF Design superfície.

  4. Crie o projeto.

  5. Adicionar um Controlarar de usuário item (ou seja, um Controlarar do usuário de Windows Forms) com o projeto.

  6. Abrir designer para o Controlarar de usuário do Windows Forms.

  7. Na ProjectNameControles de usuário do WPF guia de De caixa de ferramentas, arraste o controle de usuário do WPF para o designer.

    O Visual Studio cria automaticamente um objeto de ElementHost que hospeda o Controlarar de usuário do WPF no Controlarar de usuário Windows Forms.

  8. Gravar código que programaticamente adiciona o Controlarar de usuário do Windows Forms ao documento ou pasta de trabalho.For more information, see Adicionar controles a documentos do Office em tempo de execução.

    Observação:

    Você não pode arrastar o Controlarar de usuário do Windows Forms para o documento ou planilha no designer.

  9. Crie o projeto.

Hospedagem de controles WPF usando a classe ElementHost

Ferramentas do Visual Studio para o Office fornece recursos que o ajudam usam controles de Windows Forms em suas soluções, mas ele não fornece recursos semelhantes para controles do WPF.Por exemplo, você pode adicionar controles Windows Forms em documentos e planilhas em tempo de design arrastando-se controles do De caixa de ferramentas ou ao executar tempo usando métodos auxiliares.No entanto, essas ferramentas não estão disponíveis para controles do WPF.

Controles do WPF usar a classe ElementHost como uma camada de integração entre um controle Windows Forms ou formulário e os controles do WPF.A classe ElementHost é fornecida pelo .NET Framework, começando com a versão 3.0.

Quando você Adicionar controles do WPF à sua solução em tempo de design, Visual Studio gera automaticamente um objeto ElementHost para você.Para um explicação passo a passo que demonstra como usar a classe de ElementHost programaticamente, consulte Como: Hospedar um Controlarar de Foundation de apresentação do Windows no Windows Forms usando o ElementHost.

Recursos do WPF

Para obter mais informações sobre a arquitetura e questões de design para hospedar controles do WPF em controles Windows Forms e formulários, consulte os tópicos a seguir:

Para obter mais informações sobre como adicionar controles do WPF para controles Windows Forms e formulários no Visual Studio em tempo de design, consulte os seguintes tópicos:

Consulte também

Tarefas

Como: Adicionar um painel de ações a documentos do Word

Como: Adicionar um painel de ações a pastas de trabalho do Excel

Como: Adicionar um painel de tarefas Personalizar a um aplicativo

Como: Adicionar uma região de formulário a um projeto de suplemento do Outlook

Conceitos

Personalização de IU do Office

Controles de formulários do Windows em Visão geral de documentos do Office

Visão geral painel Ações

Visão geral de painéis de tarefas Personalizar

Criar regiões de formulário do Outlook