Compartilhar via

Usar controles do WPF em soluções do Office

Embora as soluções criadas usando as ferramentas de desenvolvimento do Office no Visual Studio sejam projetadas para funcionar diretamente com controles do Windows Forms, você também pode usar controles WPF em suas soluções. O WPF (Windows Presentation Foundation) é uma alternativa ao Windows Forms para criar interfaces de usuário. O WPF usa uma linguagem de marcação chamada XAML (Extensible Application Markup Language) para fornecer novas técnicas para incorporar interface do usuário, mídia e documentos. Para obter mais informações, consulte a visão geral do WPF.

Aplica-se a: As informações neste tópico se aplicam a projetos no nível do documento e projetos de suplemento VSTO. Consulte os recursos disponíveis pelo aplicativo do Office e pelo tipo de projeto.

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

  • Documentos e planilhas em customizações específicas para o nível do documento.

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

  • Painéis de tarefas personalizados em Suplementos VSTO.

  • Forme regiões em suplementos VSTO para Outlook.

Adicionar controles WPF a projetos do Office em tempo de projeto

Não é possível adicionar controles do WPF diretamente aos elementos da interface do usuário em soluções do Office. Em vez disso, adicione um item de Controle de Usuário (WPF) ao seu projeto e use-o como a superfície de design para controles WPF. Em seguida, adicione o controle de usuário do WPF a um elemento de interface do usuário em seu projeto.

Para adicionar controles do WPF a um painel de ações, painel de tarefas personalizado ou 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. Adicione um item de Controle de Usuário (WPF) ao seu projeto.

  3. Na Caixa de Ferramentas, adicione controles WPF à superfície de design de controle de usuário do WPF.

    Por padrão, quando o designer de controle de usuário do WPF está aberto, a Caixa de Ferramentas contém apenas controles WPF.

  4. Compile o projeto.

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

  6. Na guia ProjectNameWPF Controles de Usuário da Caixa de Ferramentas, arraste o controle de usuário WPF para o designer do painel de ações, região do formulário ou painel de tarefas personalizado.

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

  7. Recompile o projeto.

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

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

  2. Adicione um item de Controle de Usuário (WPF) ao seu projeto.

  3. Na Caixa de Ferramentas, adicione controles WPF à superfície de design de controle de usuário do WPF.

  4. Compile o projeto.

  5. Adicione um item de Controle de Usuário (ou seja, um controle de usuário do Windows Forms) ao projeto.

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

  7. Na guia Controles de Usuário do ProjectNameWPF da Caixa de Ferramentas, arraste o controle de usuário do WPF para o designer.

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

  8. Escreva um código que adiciona programaticamente o controle de usuário do Windows Forms ao documento ou à pasta de trabalho. Para obter mais informações, consulte Adicionar controles aos 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. Recompile o projeto.

Hospedar controles do WPF usando a classe ElementHost

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

Os controles do WPF usam a ElementHost classe como uma camada de integração entre um controle ou formulário do Windows Forms e os controles do WPF. Quando você adiciona controles WPF à sua solução em tempo de design, o Visual Studio gera automaticamente um ElementHost objeto para você.

Recursos do WPF

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

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

Conteúdo relacionado

  • Last updated on