Criar regiões de formulário do Outlook

Artigo
08/25/2010

Se aplica a
As informações contidas neste tópico se aplicam apenas às especificado Ferramentas do Visual Studio para o Office projetos e as versões do Microsoft Office. Tipo de Projeto Projetos de nível de aplicativo Versão do Microsoft Office Outlook 2007 For more information, see Recursos disponíveis pelo aplicativo e o tipo de projeto.

As informações contidas neste tópico se aplicam apenas às especificado Ferramentas do Visual Studio para o Office projetos e as versões do Microsoft Office.

Tipo de Projeto

Projetos de nível de aplicativo

Versão do Microsoft Office

Outlook 2007

For more information, see Recursos disponíveis pelo aplicativo e o tipo de projeto.

Você pode usar as regiões de formulário para personalizar os formulários do Microsoft Office Outlook.Ferramentas do Visual Studio para o Office fornece ferramentas Avançados que tornam mais fácil para você Design, desenvolver e depurar regiões de formulário.

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

Vantagens de usando áreas de formulário
Adicionar uma região de formulário do Outlook ao seu projeto
Usando o designer de região de formulário
Usando uma região de formulário criada no Outlook
Adicionar código de Personalizar a uma região de formulário
Criando o projeto
Depurando de uma região de formulário
Implantação de uma região de formulário

Vantagens de usando áreas de formulário

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

Personalizar a página de padrão de qualquer formulário padrão.
Adicionar até doze páginas extras a qualquer formulário padrão.
Substituir ou aumentar a qualquer Formulárioa padrão.
Exibir interface do usuário Personalizar no painel de leitura e em Inspectors.

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

Adicionar 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 Novo região de formulário ou importar uma região de formulário que foi criada no Outlook.Além disso, se você tiver uma região de formulário que você usou no outro Ferramentas do Visual Studio para o Office Adicionar-em um projeto, você pode reutilizar sua região de formulário existente.

Criando uma Novo área de formulário usando o Assistente

Para criar uma região de formulário, Adicionar um item Região de formulário do Outlook um Outlook Adicionar no projeto.Isso inicia o Assistente para Do Novo região de formulário do Outlook.

Use o Assistente para indicar se você deseja criar uma Novo região de formulário ou importar uma região de formulário que foi criada no Outlook.Para obter mais informações sobre como criar uma Novo região de formulário, consulte usando o designer de região de formulário .Para obter mais informações sobre o uso de uma região de formulário criada no Outlook, consulte Importação um formulário região 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 área	Descrição
Separate	Adiciona a região de formulário como um Novo Página em um formulário do Outlook.
Adjacentes	Acrescenta a região de formulário a parte inferior de padrão página um formulário do Outlook.
Substituição	Adiciona a região de formulário como um Novo Página que substitui a página padrão de um formulário do Outlook.
Tudo de Substituir	Substitui o formulário do Outlook inteiro a região de formulário.

Você também pode usar o assistente para especificar condições de Exibir e selecionar 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 que você faz no assistente afetam as opções disponíveis em Outro páginas do assistente.Por exemplo, se você selecionar Adjoining ou Separado no Criar uma página de Novo região de formulário do Outlook, em seguida, o Título e Description campos não disponíveis em Fornecer texto descritivo e selecione a página de Exibir preferências.Isso ocorre porque Outlook não usa esses campos a ele exibe uma região de formulário adjacentes ou separados.

Arquivos de região de formulário

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

Um arquivo de código de região de formulário.Esse arquivo tem o nome que você especificar para o item de região de formulário do Outlook no Adicionar Novo Item caixa de diálogo.Adicionar 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 do formulário e não deve ser editado diretamente.
Um arquivo de armazenamento de formulário do Outlook (.ofs).

Observação:

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

Observação:
Este arquivo somente é adicionado ao projeto se você importar uma região de formulário que 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 a interface de IFormRegionFactory.Essa é a classe de fábrica de região de formulário.A classe de fábrica de região de formulário é responsável pela criação de Novo instâncias da região de formulário.

Você pode Localizar essa classe expandindo a região de Factory de região de formulário.

O Assistente de Novo região de formulário do Outlook adiciona atributos a essa classe que especifica o nome interno da região de formulário e a mensagem de classes que Exibir a região de formulário.Você pode modificar esses atributos manualmente depois que o arquivo tiver sido 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 manipulador de eventos FormRegionInitializing é exposto no arquivo de código de região de formulário.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 tratamento eventos de região de formulário.

Adicionar uma região de formulário existente a seu projeto

Se você tiver uma região de formulário do Outlook que você usou no outro projeto Ferramentas do Visual Studio para o Office , você pode reutilizá-la no Outlook suplemento projeto atual usando a caixa de diálogo de Adicionar item existente.

A região de formulário existente deve ter um arquivo de código (.vb ou .cs); não é possível adicionar que arquivos de armazenamento de formulário do Outlook (.ofs) usando a caixa de diálogo de Adicionar item existente.No entanto, você pode criar uma Novo região de formulário Importação 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 do formulário ajuda você a criar o layout e aparência de uma região de formulário.Você pode arraste controles gerenciados para a superfície do designer, clique Duplo em controles para abrir os manipuladores de eventos e defina propriedades na janela Properties.

Observação:
Você pode Localizar propriedades que afetam a maneira como o região de formulário aparece no Outlook sob o Manifesto nó a JanelaProperties.

O designer de região de formulário é disponível somente se você selecionar Design uma Novo área de formulário in the Selecione como você deseja criar a página de formulário região do assistente Novo região de formulário do Outlook.

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

Em Gerenciador de Soluções, clique Duplo no arquivo código de região de formulário.
Em Gerenciador de Soluções, clique com o botão direito do mouse o arquivo de código de região de formulário e clique em Exibir Designer.
Em Gerenciador de Soluções, Selecionar o arquivo de código de região de formulário e em seguida, no menu Exibir, clique em Designer.

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

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

Quando você Design no Outlook, você pode adicionar controles nativos do Outlook para a região de formulário.Controles de Outlook nativos permitem que você Ligar a dados do Outlook em tempo de design.No entanto, você não é possível usar, em seguida, 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 Outlook Adicionar - projeto usando o Assistente de Novo região de formulário do Outlook.No Selecionar como você deseja criar a página de de região de formulário, Selecionar Importar um arquivo do armazenamento de formulário do Outlook (.ofs).Em seguida, você pode procurar para o local de um arquivo de armazenamento de formulário do Outlook (.ofs).(O outlook salva regiões de formulário como arquivos .OFS.)

O Assistente de Novo região de formulário do Outlook copia o arquivo de .OFS para o diretório do projeto e adiciona as referências de Controlarar para o arquivo de designer de região de formulário.Em seguida, você pode manipular eventos de Controlarar no arquivo de código de região de formulário.

Para lidar com eventos em um projeto do Visual Basic, Selecionar um evento na lista Nome do método na parte superior do editor de código.For more information, see Como: Criar manipuladores de eventos no Editor de código do Visual Basic.

Para manipular eventos em um projeto C#, assinar eventos de Controlarar no método FormRegionShowing.For more information, see Como: Assinar e cancelamento de inscrição de eventos (Guia de programação C#).

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

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

Você pode adicionar, remover ou alterar controles na região do formulário.Antes de Voltar isso, Voltar Voltarup de qualquer código que você Adicionado para o arquivo de código de região de formulário.Em seguida, Abrir o arquivo .OFS no Outlook, modificar a região de formulário e, em seguida, salvar as alterações.Use o Assistente de Novo região de formulário do Outlook para importar o arquivo .OFS modificado.Em seguida, você pode colar seu código para o novo arquivo de código de região de formulário.

Adicionar código de Personalizar a uma região de formulário

O namespace Microsoft.Office.Tools.Outlook fornece Acessar 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 item de região de formulário do Outlook automaticamente adicionada uma referência a este assembly no projeto e insere o apropriado using ou Imports instrução na parte superior do arquivo de código de região de formulário.

Você pode usar classes, métodos e propriedades no namespace Microsoft.Office.Interop.Outlook para realizar a maioria das suas tarefas de programação do 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 em Ferramentas do Visual Studio para o Office, consulte Soluções do Outlook.

Tratamento de eventos de região de formulário

O item de região de formulário do Outlook adiciona automaticamente os manipuladores de evento três seguintes ao arquivo de código de região de formulário.

Evento	Descrição
FormRegionInitializing	Ocorre antes que a região de formulário é inicializada.Você pode Marcar condições esse manipulador de eventos para determinar se o Outlook deve exibir a região de formulário.For more information, see Como: Impedir que o Outlook exibindo uma região de formulário.
FormRegionShowing	Ocorre depois 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.

Criando o projeto

Quando você Compilação um Outlook adicionar - no projeto que contém uma região de formulário, Ferramentas do Visual Studio para o Office adiciona as informações a seguir do registro:

Uma chave para cada classe de mensagem que está associado um 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 Outlook Adicionar - in.

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

Depurando de uma região de formulário

Você pode depurar um Outlook Adicionar - que contém uma região de formulário apenas como você pode depurar outros projetos de Visual Studio.Quando você inicia o depurador Visual Studio , Ferramentas do Visual Studio para o Office automaticamente inicia o Outlook.

Para exibir a região de formulário, você deve Abrir o item apropriado do Outlook.Por exemplo, se um adjacentes região de formulário será acrescentado ao Inferior de um item de email, abra um item de email.

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

Regiões de formulário são implantados automaticamente com o Outlook associado Adicionar - in.Portanto, você não precisará executar tarefas especiais para implantar uma região de formulário.Para obter mais informações sobre como implantar o Adicionar-ins, consulte Implantando soluções do Office (Sistema de 2007).