Usando os controles WPF em soluções do Office

Embora as soluções criadas usando as ferramentas de desenvolvimento do Office em Visual Studio são projetadas para trabalhar com diretamente com controles Windows Forms, você também pode usar controles WPF em suas soluções. 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 Application Markup Language () para fornecer novas técnicas para a incorporação de documentos, mídia e interface do usuário. For more information, see Introdução ao WPF.

Aplicável a: As informações neste tópico se aplicam a projetos de nível de documento e projetos de nível de aplicativo para Microsoft Office 2010 e o sistema 2007 do Microsoft Office. Para obter mais informações, consulte Recursos disponíveis pelo aplicativo do Office e o tipo de projeto.

Qualquer elemento de interface do usuário que pode hospedar controles Windows Forms em uma solução Office também pode hospedar controles do WPF. Elas incluem os seguintes elementos:

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

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

• Painéis de tarefas personalizados no nível do aplicativo add-ins.

• Regiões de formulário no nível do aplicativo add-ins para Outlook.

Para uma demonstração de vídeo relacionada, consulte Fazer como i: Usar os controles do WPF dentro de um painel de ações do Excel?.

Adicionando controles do WPF para projetos do Office em tempo de Design

É possível adicionar controles do WPF diretamente para os elementos de interface do usuário em soluções do Office. Em vez disso, adicione um Controle de usuário (WPF) item ao seu projeto e usá-la como a superfície de design para controles do WPF. Em seguida, adicione o controle de usuário do WPF para um elemento de interface do usuário no seu projeto.

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

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

2. Adicionar um Controle de usuário (WPF) item ao seu projeto.

3. Do caixa de ferramentas, adicionar os controles do WPF para a superfície de design de controle de usuário do WPF.

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

4. Build the project.

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

   • Para regiões de formulário, adicione um Região de formulário do Outlook item ao projeto. For more information, see Como: Adicionar uma região de formulário a um projeto de suplemento do Outlook.

   • Para os painéis de ações, adicione um Controle de painel de ações ou O controle de usuário item ao projeto. For more information, see Como: Adicionar um painel de ações para documentos do Word and Como: Adicionar um painel de ações para pastas de trabalho do Excel.

   • Para os painéis de tarefas personalizado, adicione um O controle de usuário item ao projeto. For more information, see Como: Adicionar um painel de tarefas personalizado a um aplicativo.

6. Da ProjectName controles de usuário do WPF guia da caixa de ferramentas, arraste o controle de usuário do WPF ao projetista para o painel de ações, a região de formulário ou o painel de tarefas personalizado.

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

7. Rebuild the project.

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

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

2. Adicionar um Controle de usuário (WPF) item ao seu projeto.

3. Do caixa de ferramentas, adicionar os controles do WPF para a superfície de design de controle de usuário do WPF.

4. Build the project.

5. Adicionar um O controle de usuário item (ou seja, um controle de usuário de Windows Forms) para o projeto.

6. Abra o designer para o controle de usuário do Windows Forms.

7. Da ProjectName controles de usuário do WPF guia da Toolbox, arraste o controle de usuário do WPF para o designer.

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

8. Escreva código que programaticamente adiciona o controle de usuário do Windows Forms para o 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 controle de usuário do Windows Forms para o documento ou planilha no designer.

9. Rebuild the project.

A hospedagem de controles do WPF, usando a classe ElementHost

Visual Studio fornece recursos que ajudam você a usar controles Windows Forms em suas soluções do Office, mas não oferece recursos semelhantes para controles do WPF. Por exemplo, você pode adicionar controles Windows Forms a documentos e planilhas em tempo de design arrastando controles a partir de Toolbox, ou em tempo de execução usando métodos auxiliares. No entanto, essas ferramentas não estão disponíveis para os controles do WPF.

Uso de controles do WPF a ElementHost classe como uma camada de integração entre um controle Windows Forms ou formulário e controles do WPF. Quando você adiciona controles do WPF à sua solução em tempo de design, Visual Studio gera automaticamente um ElementHost o objeto para você. Passo a passo demonstra como usar o ElementHost classe programaticamente, consulte Como: Hospedar um controle Janelas Formulários do WPF por meio do ElementHost.

WPF Resources

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

• Arquitetura de entrada para interoperabilidade entre Windows Forms e WPF

• Formulários do Windows e mapeamento de propriedades do WPF

• WPF e a interoperação de formulários do Windows

• Controles de Formulários do Windows e Controles WPF Equivalentes

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

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

• Demonstra Passo a passo: Organizando o conteúdo do WPF no Windows Forms em tempo de Design

• Demonstra Passo a passo: Conteúdo do estilo do WPF

Consulte também

Tarefas

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

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

Como: Adicionar um painel de tarefas personalizado a um aplicativo

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

Conceitos

Controles do Windows Forms em Visão geral de documentos do Office

Outros recursos

Personalização de interface do usuário do Office

Visão geral painel Ações

Visão geral sobre painéis de tarefas personalizado

Criação de regiões de formulário do Outlook