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

Você pode usar regiões do formulário para personalizar o Microsoft Office Outlook.Visual Studio fornece ferramentas avançados que facilitam para você criar, desenvolver, e depure regiões do formulário.

Aplicável a: As informações neste tópico se aplicam a projetos de nível de aplicativo para Outlook 2013 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 de usar regiões do formulário

• Adicionando uma região de formulário do Outlook ao seu projeto

• Usando o designer da 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

• Criando o projeto

• Depurando uma região de formulário

• Implantando uma região de formulário

Vantagens de usar regiões do formulário

Regiões do formulário oferecem vários aprimoramentos sobre o desenvolvimento tradicional de formulários do Outlook:

• Personalizar a página padrão do formulário padrão.

• Adicione anterior a 12 páginas adicionais para o formulário padrão.

• Substitua todo ou aumentar o formulário padrão.

• Exibir UI personalizada no painel de leitura e em inspectores.

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

Adicionando uma região de formulário do Outlook ao seu projeto

Você pode usar o assistente de Novo região de formulário do Outlook para criar uma nova região de formulário ou para importar uma região de formulário que é criada no Outlook.Além de isso, se você tiver uma região de forma que você usa em outro projeto do suplemento ao Outlook, você pode reutilizar sua região formulário existente.

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

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

Use o assistente para indicar se você deseja criar uma nova região de formulário ou para importar uma região de formulário que é criada no Outlook.Para obter mais informações sobre como criar uma nova região de formulário, consulte Usando o designer da região de formulário.Para obter mais informações sobre como usar uma região de formulário criada no Outlook, consulte Importando uma região de formulário criada no Outlook.

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

Tipo da região	Descrição
separado	Adiciona a região de formulário como uma nova página em um formulário do Outlook.
união	Acrescenta a área do formulário para a parte inferior da página padrão de um formulário do Outlook.
substituição	Adiciona a região de formulário como uma nova página que substitui a página padrão de um formulário do Outlook.
Substituir- qualquer	Substitui o formulário inteiro do Outlook com a área do formulário.

Você também pode usar o assistente para especificar as condições de exibição e para selecionar o tipo do formulário para estender.Para obter mais informações, consulte Como: adicionar uma região de formulário a um projeto de suplemento do Outlook.

Opções que você fizer na influência do assistente as opções que estão disponíveis no outro assistente página.Por exemplo, se você selecionar união ou Separado na página de Crie uma nova região de formulário do Outlook , então os campos de Título e de Descrição não está disponível na página de Forneça texto descritivo e selecione suas preferências de exibição .Isso ocorre porque o Outlook não usa esses campos quando exibe uma união ou não separam a área do formulário.

Arquivos da região de formulário

Quando você concluir o assistente de Novo região de formulário do Outlook , o Visual Studio adiciona automaticamente os seguintes arquivos para seu projeto:

• Um arquivo de código de área do formulário.Este arquivo possui o nome que você especificar para o item de Região do Formulário do Outlook na caixa de diálogo de Adicionar novo item .Adicione código para eventos da região do formulário de manipular a este arquivo.

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

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

  Observação
  Este arquivo é adicionado ao projeto somente se você importar uma região de formulário que foi criado no Outlook.

Classe de factory da região de formulário

O arquivo de código de área do formulário contém uma classe parcial que implementa a interface de IFormRegionFactory .Esta é a classe de factory da região do formulário.A classe de factory da região de formulário é responsável para criar novas instâncias da região do formulário.

Você pode achar esta classe expandir a região de Fábrica da região de formulário .

O assistente de Novo região de formulário do Outlook adicionar atributos a essa classe que especificam o nome da região interno do formulário e as classes de mensagem que exibe a área do formulário.Você pode alterar esses atributos manualmente depois que o arquivo foi adicionado ao projeto.

A maioria da classe de factory da região de formulário é implementada no arquivo de designer da região do formulário.Em o entanto, o manipulador de eventos de FormRegionInitializing é exposta no arquivo de código de área do formulário.Você pode usar este manipulador de eventos para especificar se Outlook deve exibir a área do formulário.Para obter mais informações, consulte Manipulando eventos da região de formulário.

Adicionando uma região formulário existente ao projeto

Se você tiver uma região de formulário do Outlook que você use em outro projeto do Outlook, você pode reutilizá-lo no projeto atual do suplemento do Outlook usando a caixa de diálogo de Adicionar item existente .

A região formulário existente deve ter um arquivo de código (.vb ou .cs); você não pode adicionar arquivos de armazenamento do formulário do Outlook .ofs () usando a caixa de diálogo de Adicionar item existente .Em o entanto, você pode criar uma nova área do formulário para importar um arquivo de armazenamento de formulário do Outlook.Para obter mais informações, consulte Como: adicionar uma região de formulário a um projeto de suplemento do Outlook.

Usando o designer da região de formulário

O designer da região do formulário ajuda você a criar o layout e aparência de uma região do formulário.Você pode arrastar controles gerenciados para a superfície de designer, clique duas vezes em controles para abrir manipuladores de eventos, e defina propriedades na janela de Propriedades .

Observação
Você pode localizar as propriedades que afetam a maneira que a região de formulário aparece no Outlook abaixo do nó de Manifesto na janela de Propriedades .

O designer da região do formulário está disponível somente se você selecionar Criar uma nova região de formulário na página de Selecione como você deseja criar a região de formulário do assistente de Novo região de formulário do Outlook .

Existem três maneiras para abrir o designer da região do formulário:

• Em Gerenciador de Soluções, clique duas vezes no arquivo de código de área do formulário.

• Em Gerenciador de Soluções, clique com o botão direito do mouse no arquivo de código de área do formulário, clique em Exibir Designer.

• Em Gerenciador de Soluções, selecione o arquivo de código de área do formulário, e em seguida, no menu de Modo de Visualização , clique em Designer.

O designer da região do formulário oferece suporte somente a controles gerenciados.Você não pode adicionar controles do Outlook de ambos.

Importando uma região de formulário criada no Outlook

Quando você cria no Outlook, você pode adicionar controles do Outlook de nativo para a área do formulário.Os controles do Outlook de ambos permite associar em tempo de design a dados do Outlook.Em o entanto, você não pode usar o designer da região do formulário para adicionar controles gerenciados ou para modificar o design da região do formulário.

Você pode importar regiões de formulário em um projeto do suplemento ao Outlook usando o assistente de Novo região de formulário do Outlook .Em a página de Selecione como você deseja criar a região de formulário , selecione Importar um arquivo de armazenamento do formulário () .ofs do Outlook.Você pode então navegue até o local de um arquivo do arquivo de armazenamento de formulário do Outlook .ofs ().(Outlook salva regiões do formulário como arquivos de .ofs.)

O assistente de Novo região de formulário do Outlook copia o arquivo de .ofs para o diretório do projeto e adicionar referências do controle para o arquivo de designer da região do formulário.Você pode então manipular eventos do controle no arquivo de código de área do formulário.

Para manipular eventos em um projeto Visual Basic, selecione um evento de lista de nomes de método na parte superior do editor de códigos.

Para manipular eventos em um projeto C#, assinar eventos do controle no método de FormRegionShowing .Para obter mais informações, consulte Como: assinar e cancelar a inscrição de eventos (guia de programação do C#).

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

Observação
Para importar uma região de formulário, você deve estar trabalhando em um projeto que tem como alvo a mesma versão do Outlook instalado no computador de desenvolvimento.Por exemplo, se você tiver Outlook 2010 instalado, importar uma região de formulário só funcionará em um projeto foi criado usando o modelo de projeto de Suplemento do Outlook 2010 .

Atualizando o design de uma região importado do formulário

Você pode adicionar, remover, ou alterar controles na região do formulário.Antes de fazer isso, faça backup qualquer código que você adiciona ao arquivo de código de área do formulário.Em, abra o arquivo de .ofs no Outlook, modifique a área do formulário, e então salve as alterações.use o assistente de Novo região de formulário do Outlook para importar o arquivo alterado de .ofs.Você pode então cole o código no novo arquivo de código de área do formulário.

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

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

Você pode usar classes, métodos, propriedades e no namespace de Microsoft.Office.Interop.Outlook para realizar a maioria do Outlook tarefas de programação do.Para obter mais informações sobre o modelo de objeto do Outlook, consulte Visão geral sobre o modelo de objeto do Outlook.Para exemplos de tarefas típicas que utilizam o modelo de objeto do Outlook, consulte Soluções do Outlook.

Manipulando eventos da região de formulário

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

Evento	Descrição
FormRegionInitializing	Ocorre antes que a região de formulário é inicializada.Você pode condições de verificação em este manipulador de eventos determinar se o Outlook deve exibir a área do formulário.Para obter mais informações, consulte 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 é criado mas antes da área do formulário aparece.
FormRegionClosed	Ocorre antes que a região de formulário é fechada.

Criando o projeto

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

• Uma chave para cada classe de mensagem que está associada com um ou mais áreas do formulário.

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

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

Depurando 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ê faria para depurar outros projetos de Visual Studio .Quando você inicia o depurador do Visual Studio, Visual Studio inicia automaticamente Outlook.

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

Implantando uma região de formulário

Regiões do formulário são implantados automaticamente com o suplemento associado ao Outlook.Portanto, você não precisará executar qualquer tarefas especial implantar uma região do formulário.Para obter mais informações sobre a implantação de suplementos, consulte Implantando uma solução do Office.

Tópicos relacionados

Nome	Descrição
Diretrizes para criação de regiões de formulário do Outlook	Fornece informações que podem ajudá-lo a otimizar as regiões do formulário e a 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 do formulário para estender um formulário do Microsoft Office Outlook de padrão ou personalizada usando o assistente de Novo região de formulário do Outlook .
A associação de uma região de formulário com uma classe de mensagem do Outlook	Explica como especificar que os itens do Microsoft Office Outlook exibem uma região de formulário associando a região de formulário com a classe de mensagem de cada item.
Passo a passo: Criando uma região de formulário do Outlook	Mostra como criar uma região de formulário personalizado que aparece como uma nova página na janela de inspector de um item contato.
Passo a passo: Importação de uma região de formulário que é criada no Outlook	Mostra como criar uma região de formulário no Microsoft Office Outlook, e importar na região de formulário em um projeto do suplemento ao Outlook usando o assistente de Novo região de formulário do Outlook .
Acessando uma região de formulário em tempo de execução	Descreve como escrever código para a apresentação, ocultar, ou alterar controles em uma área do formulário, e permitem aos usuários executar o código de outras áreas em seu projeto usando a classe de Globals .
Como: impedir a exibição de uma região de formulário do Outlook	Mostra como impedir que o Microsoft Office Outlook exibe uma região do formulário para um item específico.
Mostra como acessar o item do Outlook em que uma região de formulário aparece.
Ações personalizadas em regiões de formulário do Outlook	Descreve como permitir que os usuários possam responder a um item do Outlook.