Exemplo de Gerente de interface do usuário

Artigo
08/25/2010

Observação:
Este exemplo é executado somente no Microsoft Office Outlook 2007.

Este exemplo demonstra como personalizar a interface de usuário (UI) do Microsoft Office Outlook 2007 Implementando interfaces de extensibilidade em um Adicionar-in.Este exemplo usa interfaces de extensibilidade para criar uma personalização da Faixa de Opções, um painel de tarefas personalizado e uma região de formulário personalizado.

Este exemplo também demonstra uma maneira de coordenar os elementos de interface do usuário Personalizars de uma janela Inspector específico.O código neste exemplo garante que a personalização da Faixa de Opções, painel de tarefas personalizado e região de formulário personalizado em um Inspector podem se corretamente comunicar uns com os outros.Eles devem se comunicar de forma que é isolada de outras instâncias desses elementos da interface do usuário Personalizar que pode ser Abrir em outros Inspectors.

Por exemplo, o usuário pode ter vários Inspectors abrir, cada um deles possui uma Faixa de Opções Personalizar, o painel de tarefas e a região de formulário.Quando o usuário interage com um desses elementos — por exemplo, clicando em um botão na Faixa de Opções — ele pode causar uma Alterar em outro elemento — por exemplo, ocultando o painel de tarefas.O código deve garantir que apenas os elementos no um Inspector estejam afetadas e não outras instâncias desses elementos de interface do usuário Personalizars em outros Inspectors.

Este exemplo usa um conjunto de classes que quebra Inspector e objetos do painel de tarefas Personalizar para garantir que um Nova Tarefa painel será exibida com cada mensagem de email e de tarefa que o usuário abre.O exemplo também cria botões Personalizars de Faixa de opções que podem ser usados para ocultar ou exibir o painel de tarefas em cada tarefa ou mensagem de email, e exibe uma região de formulário Personalizar em cada tarefa.Para obter mais informações sobre a estrutura de neste exemplo, consulte componentes do exemplo de Gerente de interface do usuário.

Para obter informações sobre como instalar o projeto de exemplo no seu computador, consulte Como: Instalar e usar arquivos de exemplo encontrados na Ajuda.

Observação:
Embora esse exemplo Use interfaces de extensibilidade para criar uma personalização da Faixa de Opções, um painel de tarefas personalizado e uma região de formulário Ferramentas do Visual Studio para o Office fornece classes e os designers que você pode usar em vez disso.Essas classes e designers simplificam o processo de trabalhar com esses recursos.Para obter mais informações, consulte Designer de Faixa de Opções, Visão geral de painéis de tarefas Personalizar e Criar regiões de formulário do Outlook.

Embora esse exemplo Use interfaces de extensibilidade para criar uma personalização da Faixa de Opções, um painel de tarefas personalizado e uma região de formulário Ferramentas do Visual Studio para o Office fornece classes e os designers que você pode usar em vez disso.Essas classes e designers simplificam o processo de trabalhar com esses recursos.Para obter mais informações, consulte Designer de Faixa de Opções, Visão geral de painéis de tarefas Personalizar e Criar regiões de formulário do Outlook.

Observação de segurança:
Esse código de exemplo é destinado a ilustrar um conceito, e ele mostra somente o código que é relevante para esse conceito.Ele pode não atender aos requisitos de segurança de um ambiente específico e não deve ser usado exatamente como mostrado.Recomendamos que você adicione segurança e código de tratamento de erros para tornar seus projetos mais seguros e robustos.A Microsoft fornece o código de exemplo "como está" sem garantias.

Esse código de exemplo é destinado a ilustrar um conceito, e ele mostra somente o código que é relevante para esse conceito.Ele pode não atender aos requisitos de segurança de um ambiente específico e não deve ser usado exatamente como mostrado.Recomendamos que você adicione segurança e código de tratamento de erros para tornar seus projetos mais seguros e robustos.A Microsoft fornece o código de exemplo "como está" sem garantias.

Download sample

Para executar este exemplo.

Pressione F5.
No Outlook, criar um Novo Tarefa.
Na faixa de opções da tarefa, clique na guia de De Adicionar-ins.
No AAgruparar de De Gerente de interface do usuário, clique em TaskPane botão.

Verifique se o painel de tarefas SimpleControl aparece Avançar para a janela de tarefa.
No Mostrar AAgruparar, clique no botão de UIM.

Verifique se a região de formulário Personalizar aparece no painel de leitura do Abrir tarefa.A região de formulário exibe uma lista de grãos de café e uma caixa de texto que contém o número de café orders que tiverem sido concedidos.
Selecionar um ou mais tipos de grãos de café na região de formulário.

Verifique se cada tipo de café bean que você selecionar é adicionado ao painel de tarefas do SimpleControl.
Na Faixa de Opções, no AAgruparar Adicionar-in Serviços, clique no botão de De enviar.

Verifique se uma Novo mensagem é enviada para o destinatário nome@example.com e a mensagem de email contém Tudo tipos de grãos de café que você Selecionado na região de formulário.

Porque a mensagem de email representa uma ordem de café, o número de ordens colocados na região de formulário é incrementado.

Requisitos

Este exemplo requer os seguintes aplicativos:

Ferramentas do Visual Studio para o Office.
Microsoft Office Outlook 2007.

Demonstra

Este exemplo demonstra os seguintes conceitos:

Criando uma personalização da Faixa de Opções, implementar a interface de Microsoft.Office.Core.IRibbonExtensibility em um Adicionar-in.
Criando um painel de tarefas Personalizar, implementar a interface de Microsoft.Office.Core.ICustomTaskPaneConsumer em um Adicionar-in.
Criando uma região de formulário Personalizar, implementar a interface de Microsoft.Office.Interop.Outlook.FormRegionStartup em um Adicionar-in.
Gerenciando e sincronizar a Faixa de Opções personalização, painel de tarefas personalizado e região de formulário em mensagens de email diferentes e tarefas no Outlook.

Componentes do exemplo de Gerente de interface do usuário

A solução de exemplo inclui dois projetos:

Microsoft.Samples.vsto.UiManager é um Adicionar no projeto para o Outlook.Este projeto contém as implementações das interfaces de extensibilidade e Outro classes e os arquivos que oferecem suporte a essas implementações.
Microsoft.Samples.vsto.AddinUtilities é umBiblioteca de Classess que inclui classes de gerenciamento da interface do usuário e interfaces que são usados pelo projeto de suplemento do Outlook.

Esses projetos fornecem componentes que implementam o painel de tarefas personalizado, a personalização da Faixa de Opções e a região de formulário e também componentes que ajudam a sincronizar e gerenciar esses recursos.

Componentes de gerenciamento de interface do usuário

A tabela a seguir descreve os arquivos de projeto que fornecem código para a personalização da Faixa de Opções.

File	Descrição
ThisAddIn.cs/vb	Contém a Substituir de método de RequestService e do código que cria um novo painel de tarefas Personalizar para cada janela de inspetor.Para obter mais informações sobre esse método, consulte Personalizando recursos de interface do usuário usando interfaces de extensibilidade.
UserInterfaceContainer.cs/vb	Define a classe UserInterfaceContainer.Cada objeto UserInterfaceContainer gerencia a região de formulário, painel de tarefas e personalização da Faixa de Opções para um Simples mensagem de email ou tarefa.
UserInterfaceElements.cs/vb	Define a classe UserInterfaceElements.Isso mantém a coleção de objetos de UserInterfaceContainter usados pelo Adicionar-in.
IFormRegionControls.cs/vb IRibbonConnector.cs/vb	Define as interfaces que várias classes nos projetos Microsoft.Samples.vsto.UiManager e Microsoft.Samples.vsto.AddinUtilities usam para se comunicar uns com os outros.

Componentes de painel de tarefas Personalizars

A tabela a seguir descreve os arquivos de projeto que fornecem código para o painel de tarefas Personalizar.

File	Descrição
TaskPaneConnector.cs/vb	Define a classe TaskPaneConnector.Essa classe implementa a interface de Microsoft.Office.Core.ICustomTaskPaneConsumer.
SimpleControl.cs/vb	Define o UserControl que fornece a interface do usuário do painel de tarefas Personalizar.Esse Controlarar tem atributos que expõem o Controlarar para com.

Componentes da Faixa de Opções

A tabela a seguir descreve os arquivos de projeto que fornecem código para a personalização da Faixa de Opções.

File	Descrição
RibbonConnector.cs/vb	Define a classe RibbonConnector.Essa classe implementa a interface de Microsoft.Office.Core.IRibbonExtensibility.
SimpleRibbon.xml TaskRibbon.xml	Contém seqüências de caracteres XML da Faixa de Opções que são retornadas pelo método GetCustomUI da implementação de interface Microsoft.Office.Core.IRibbonExtensibility.

RibbonConnector.cs/vb

Define a classe RibbonConnector.Essa classe implementa a interface de Microsoft.Office.Core.IRibbonExtensibility.

SimpleRibbon.xml

TaskRibbon.xml

Contém seqüências de caracteres XML da Faixa de Opções que são retornadas pelo método GetCustomUI da implementação de interface Microsoft.Office.Core.IRibbonExtensibility.

Componentes de região de formulário

A tabela a seguir descreve os arquivos de projeto que fornecem código para a região de formulário Personalizar que é exibida na tarefa Inspectors.

File	Descrição
FormRegionConnector.cs/vb	Define a classe FormRegionConnector.Essa classe implementa a interface de Microsoft.Office.Interop.Outlook.FormRegionStartup.
FormRegionControls.cs/vb	Define uma classe que gerencia a controles em cada instância de região de formulário.
PictureConverter.cs/vb	Converte um Image em um IPictureDisp que pode ser usado para exibir um ícone em uma região de formulário.
SimpleFormRegion.ofs	Define a INTERFACE da região de formulário.
SimpleFormRegion.xml	Contém o manifesto para a região de formulário.
SimpleFormRegion.reg	Cria as entradas do Registro que são necessárias para carregar a região de formulário.

Consulte também

Partilhar via