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

Você pode usar regiões de formulário para personalizar os formulários de Microsoft Office Outlook. Visual Studio fornece ferramentas avançadas que tornam mais fácil para você projetar, desenvolver e depurar as regiões de formulário.

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

Este tópico fornece as seguintes informações:

• Vantagens do uso de regiões de formulário

• A adição de uma região de formulário do Outlook ao projeto

• Usando o Designer de região de formulário

• Usando uma região de formulário criada no Outlook

• Adicionando código personalizado para uma região de formulário

• Compilar o projeto

• Depuração de uma região de formulário

• A implantação de uma região de formulário

Vantagens do uso de regiões de formulário

Regiões de formulário oferecem vários aperfeiçoamentos sobre desenvolvimento de formulários do Outlook tradicional:

• Personalize a página padrão de qualquer formulário padrão.

• Adicione até 12 páginas extras em nenhum formato padrão.

• Substituir ou aumentar qualquer formulário padrão.

• Exibir UI personalizada no painel de leitura e inspetores.

Para obter mais informações, consulte Personalizando páginas de formulários e regiões de formulário.

A adição de uma região de formulário do Outlook ao projeto

Você pode usar o Nova região de formulário do Outlook o Assistente para criar uma nova região de formulário ou importar uma região de formulário foi criada no Outlook. Além disso, se você tiver uma região de formulário que você usou em outro Outlook suplemento do projeto, você pode reutilizar sua região de formulário existente.

Criando uma nova região de formulário usando o Assistente

Para criar uma região de formulário, adicione um Região de formulário do Outlook item a um projeto de suplemento do Outlook. Isso inicia o Nova região de formulário do Outlook assistente.

Use o Assistente para indicar se deseja criar uma nova região de formulário ou importar uma região de formulário foi criada no Outlook. Para obter mais informações sobre como criar uma nova região de formulário, consulte usando o Designer de região do formulário. Para obter mais informações sobre o uso de uma região de formulário criada no Outlook, consulte a importação de uma região de formulário criado no Outlook.

Use o Assistente para especificar o tipo de região de formulário que você deseja criar. A tabela a seguir descreve cada tipo de região de formulário.

Tipo de região	Description
Separate	Adiciona a região de formulário como uma nova página em um formulário do Outlook.
Adjacentes	Acrescenta a região de formulário na parte inferior da página padrão de um formulário Outlook.
Substituição	Adiciona a região de formulário como uma nova página que substitui a página padrão do formulário do Outlook.
Substituir tudo	Substitui todo o formulário do Outlook com a região de formulário.

Você também pode usar o Assistente para especificar condições de exibição e selecione o tipo de formulário para estender. For more information, see Como: Adicionar uma região de formulário a um projeto de suplemento do Outlook.

As seleções feitas no Assistente afetam as opções que estão disponíveis em outras páginas do assistente. Por exemplo, se você selecionar Adjoining ou separado na criar uma nova região de formulário do Outlook página, em seguida, a título e Descrição campos estão disponíveis no fornecer texto descritivo e selecionar suas preferências de exibição página. Isso ocorre porque o Outlook não usa esses campos ao exibir uma região de formulário adjacente ou separados.

Arquivos de região de formulário

Ao concluir a Nova região de formulário do Outlook do assistente, Visual Studio os arquivos a seguir adiciona automaticamente ao seu projeto:

• Um arquivo de código de região de formulário. Esse arquivo tem o nome que você especificar para o Região de formulário do Outlook item no Add New Item caixa de diálogo. Adicione código para manipular eventos de região de formulário para este arquivo.

• Um arquivo de código do designer de região de formulário. Este arquivo contém o código gerado pelo designer de região de formulário e não deve ser editado diretamente.

• Um arquivo de armazenamento de formulário do Outlook (. ofs).

  Observação
  Esse arquivo só é adicionado ao projeto, se você importar uma região de formulário foi criada no Outlook.

Classe de fábrica de região de formulário

O arquivo de código de região de formulário contém uma classe parcial que implementa o IFormRegionFactory interface. Esta é a classe de fábrica da região de formulário. A classe de fábrica da região de formulário é responsável pela criação de novas instâncias de região de formulário.

Você pode encontrar essa classe, expandindo o Fábrica da região de formulário região.

O Nova região de formulário do Outlook assistente adiciona atributos para essa classe que especificam o nome interno da região de formulário e as classes de mensagens que exibem a região de formulário. Você pode modificar esses atributos manualmente depois que o arquivo foi adicionado ao projeto.

A maioria da classe de fábrica de região de formulário é implementado no arquivo de designer de região de formulário. No entanto, o FormRegionInitializing manipulador de eventos é exposta no arquivo de código do formulário de região. Você pode usar esse manipulador de eventos para especificar se o Outlook deve exibir a região de formulário. Para obter mais informações, consulte Manipulação de eventos da região de formulário.

A adição de uma região de formulário existente ao projeto

Se você tiver uma região de formulário do Outlook que você usou em outro projeto do Outlook, você pode reutilizá-la no Outlook suplemento do projeto atual usando o Add Existing Item caixa de diálogo.

A região de formulário existente deve ter um arquivo de código (. vb ou. cs); não é possível adicionar arquivos de armazenamento de formulário do Outlook (. ofs) usando o Add Existing Item caixa de diálogo. No entanto, você pode criar uma nova região de formulário importando um arquivo de armazenamento de formulário do Outlook. For more information, see Como: Adicionar uma região de formulário a um projeto de suplemento do Outlook.

Usando o Designer de região de formulário

O designer de região de formulário ajuda a projetar o layout e aparência de uma região de formulário. Arraste os controles gerenciados para a superfície do designer, clique duas vezes em controles para abrir os manipuladores de eventos e definir propriedades de Propriedades janela.

Observação
Você pode encontrar as propriedades que afetam a maneira como a região de formulário aparece no Outlook sob o manifesto nó a Propriedades janela.

O designer de região de formulário só estará disponível se você selecionar Design uma nova região de formulário na Selecione como deseja criar a região de formulário página da Nova região de formulário do Outlook assistente.

Há três maneiras de abrir o designer de região de formulário:

• Em Solution Explorer, duas vezes no arquivo de código de região de formulário.

• Em Solution Explorer, clique com o botão direito no arquivo de código de área de formulário e, em seguida, clique em View Designer.

• Em Solution Explorer, selecione o arquivo de código de região de formulário e em seguida, na Exibir menu, clique em Designer.

O suporte de designer de região de formulário somente controles gerenciados. Não é possível adicionar controles nativos do Outlook.

A importação de uma região de formulário criada no Outlook

Quando você cria no Outlook, você pode adicionar controles nativos do Outlook para a região de formulário. Controles nativos do Outlook permitem que você vincular-se aos dados do Outlook em tempo de design. No entanto, em seguida, é possível usar o designer de região de formulário para adicionar controles gerenciados ou alterar o design da região de formulário.

Você pode importar regiões de formulário para um projeto de suplemento do Outlook usando o Nova região de formulário do Outlook assistente. Sobre o Selecione como deseja criar a região de formulário , selecione Importar um arquivo de armazenamento de formulário do Outlook (. ofs). Em seguida, você pode navegar para o local de um arquivo de armazenamento de formulário do Outlook (. ofs). (O outlook salva regiões de formulário como os arquivos. ofs).

O Nova região de formulário do Outlook assistente copia o arquivo. ofs ao diretório do projeto e adiciona o controle de referências ao arquivo de designer de região de formulário. Você pode manipular eventos de controle no arquivo de código de região de formulário.

Para lidar com eventos em um projeto de Visual Basic, selecione um evento na lista Nome do método na parte superior do Editor de código. For more information, see How to: Create Event Handlers in the Visual Basic Code Editor.

Para manipular eventos em um projeto C#, inscreva-se control events in a FormRegionShowing método. For more information, see How to: Se inscrever e cancelar a inscrição de eventos (guia de programação de C#).

Você pode alterar as propriedades da região de formulário no InitializeManifest o método da classe do formulário região fábrica.

Observação
Para importar uma região de formulário, você deve estar trabalhando em um projeto voltado para a mesma versão do Outlook que você instalou no computador de desenvolvimento. Por exemplo, se você tiver 2010 do Outlook instalado, a importação de um formulário região só funcionará em um projeto foi criada usando o suplemento do Microsoft Outlook 2010 o modelo de projeto.

Atualizando o Design de uma região formulário importado

Você pode adicionar, remover ou alterar os controles na região de formulário. Antes de fazer isso, fazer backup de qualquer código que você adicionou ao arquivo de código de área de formulário. Em seguida, abra o arquivo. ofs no Outlook, modificar a região de formulário e salve as alterações. Use o Nova região de formulário do Outlook o Assistente para importar o arquivo. ofs de modificado. Você pode colar seu código para o novo arquivo de código de região de formulário.

Adicionando código personalizado para uma região de formulário

O Microsoft.Office.Tools.Outlook namespace fornece acesso a classes que representam a região de formulário, o item do Outlook que exibe a região de formulário e outros itens úteis. O Região de formulário do Outlook item automaticamente adiciona uma referência a esse assembly no projeto e insere o apropriado using ou Imports a instrução na parte superior do arquivo de código do formulário de região.

Você pode usar as classes, métodos e propriedades do Microsoft.Office.Interop.Outlook o namespace para realizar a maioria das suas tarefas de programação Outlook. Para obter mais informações sobre o modelo de objeto do Outlook, consulte Visão geral do modelo de objeto do Outlook. Para obter exemplos de tarefas comuns que tornam o uso do modelo de objeto do Outlook, consulte Soluções do Outlook.

Manipulação de eventos da região de formulário

O Região de formulário do Outlook item adiciona automaticamente os manipuladores de eventos de três a seguir para o arquivo de código de região de formulário.

Event	Description
FormRegionInitializing	Ocorre antes que a região de formulário é inicializada. Você pode verificar as condições em que esse manipulador de eventos para determinar se o Outlook deve exibir a região de formulário. For more information, see Como: Impedir a exibição de uma região de formulário do Outlook.
FormRegionShowing	Ocorre depois que uma instância da região de formulário é criada, mas antes do formulário região é exibida.
FormRegionClosed	Ocorre antes que a região de formulário é fechada.

Compilar o projeto

Quando você cria um Outlook suplemento do projeto que contém uma região de formulário, o Visual Studio adiciona as seguintes informações no registro:

• Uma chave para cada classe de mensagem que está associado uma ou mais regiões de formulário.

• Uma entrada para cada região de formulário e um valor associado que representa o nome do suplemento do Outlook.

O Outlook usa essas informações para carregar as regiões de formulário.

Depuração de uma região de formulário

Você pode depurar um suplemento do Outlook que contém uma região de formulário, exatamente como você deseja depurar outros Visual Studio projetos. Quando você iniciar o Visual Studio automaticamente inicia o depurador, Visual Studio Outlook.

Para exibir a região de formulário, você deve abrir o item apropriado do Outlook. Por exemplo, se uma região de formulário adjacente é acrescentada à parte inferior de um item de email, abra um item de email.

A implantação de uma região de formulário

Regiões de formulário são implantados automaticamente com o suplemento do Outlook associado. Portanto, não é necessário que executar quaisquer tarefas especiais para implantar uma região de formulário. Para obter mais informações sobre como implantar o add-ins, consulte Implantar soluções do Office.

Related Topics

Title	Description
Diretrizes para criação de regiões de formulário do Outlook	Fornece informações que podem ajudá-lo a otimizar suas regiões de formulário e evitar possíveis problemas.
Como: Adicionar uma região de formulário a um projeto de suplemento do Outlook	Mostra como criar uma região de formulário para estender um formulário de Microsoft Office Outlook de padrão ou personalizado usando o Nova região de formulário do Outlook assistente.
Associar uma região de formulário uma classe de mensagem do Outlook	Explica como especificar quais itens de Microsoft Office Outlook exibem uma região de formulário, associando-se a região de formulário com a classe de mensagem de cada item.
Como: Adicionar uma entidade a um modelo	Mostra como criar uma região de formulário personalizado que aparece como uma nova página na janela do Inspetor de propriedades de um item de contato.
Demonstra Passo a passo: A importação de uma região de formulário que é criada no Outlook	Mostra como criar uma região de formulário de Microsoft Office Outlook e, em seguida, importe a região de formulário para um projeto de suplemento do Outlook usando o Nova região de formulário do Outlook assistente.
Como: Adicionar um método localizador	Descreve como escrever código para mostrar, ocultar ou modificar controles em uma região de formulário e permitir que os usuários executar o código de outras áreas do projeto usando o Globals classe.
Como: Impedir a exibição de uma região de formulário do Outlook	Mostra como impedir que o Microsoft Office Outlook de exibição de uma região de formulário para um item específico.
Como: Acessar o Item do Outlook exibe a região de formulário	Mostra como acessar o item do Outlook na qual uma região de formulário é exibido.
Como: Adicionar um método específico de localizador	Descreve como habilitar usuários responder a um item do Outlook.
Como: Adicionar um método criador	Mostra como adicionar uma ação personalizada usando um Região de formulário do Outlook item.