Diretrizes para criação de 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.

As seguintes informações podem ajudar a otimizar suas regiões de formulário e evitar possíveis problemas:

Usando a região de formulário nomes de.
Desabilitando de herança de região de formulário.
Noções básicas sobre tipos e nomes de classe da mensagem.
Criação de regiões de formulário adjacente para a leitura do painel.
Usando o ícone ideal tamanhos.

Para obter mais informações sobre regiões de formulário, consulte Criar regiões de formulário do Outlook.

Usando nomes de região de formulário

Há vários nomes usados para descrever a região de formulário.É importante compreender a diferença entre esses nomes e como eles afetam a região de formulário.A tabela a seguir descreve cada nome.

Nome da região de formulário	Descrição
Nome do item de região de formulário	O nome que você especificar para o item de região de formulário do Outlook no Adicionar Novo Item caixa de diálogo.Esse é o nome do arquivo de código de região de formulário que aparece na Gerenciador de Soluções.
Propriedade FormRegionName	Você especificar esse nome no Fornecer um texto descritivo e Selecionar a página de Exibir preferências do assistente Novo região de formulário do Outlook.Esse nome é exibido como a propriedade de FormRegionName na janelaProperties de . Use a propriedade FormRegionName para especificar o rótulo que identifica a região de formulário na interface de usuário do Outlook (UI).Para regiões de formulário separado, esse nome é exibido como um botão na Faixa de Opções do item do Outlook. Para adjacentes regiões de formulário, esse nome aparece como texto de cabeçalho acima a região de formulário.
Atributo Microsoft.Office.Tools.Outlook.FormRegionName	Quando você Adicionar um item de De região de formulário do Outlook para o projeto, Ferramentas do Visual Studio para o Office define essa propriedade como o nome totalmente qualificado da região de formulário.O nome totalmente qualificado padrão é o nome do Adicionar - in conectado ao nome de região de formulário por um ponto — por exemplo, OutlookAddIn1.FormRegion1. Esse nome totalmente qualificado também aparece como um atributo na parte superior da classe de fábrica de região de formulário. Usar o atributo de Microsoft.Office.Tools.Outlook.FormRegionName para identificar exclusivamente a região de formulário entre Tudo Outlook Adicionar-ins.Você não pode alterar o valor do atributo Microsoft.Office.Tools.Outlook.FormRegionName , renomeando-o item de região de formulário ou alterando a propriedade FormRegionName.Para alterar esse nome, é necessário modificar o atributo Microsoft.Office.Tools.Outlook.FormRegionName no arquivo de código de região de formulário.

Nome do item de região de formulário

O nome que você especificar para o item de região de formulário do Outlook no Adicionar Novo Item caixa de diálogo.Esse é o nome do arquivo de código de região de formulário que aparece na Gerenciador de Soluções.

Propriedade FormRegionName

Você especificar esse nome no Fornecer um texto descritivo e Selecionar a página de Exibir preferências do assistente Novo região de formulário do Outlook.Esse nome é exibido como a propriedade de FormRegionName na janelaProperties de .

Use a propriedade FormRegionName para especificar o rótulo que identifica a região de formulário na interface de usuário do Outlook (UI).Para regiões de formulário separado, esse nome é exibido como um botão na Faixa de Opções do item do Outlook.

Para adjacentes regiões de formulário, esse nome aparece como texto de cabeçalho acima a região de formulário.

Atributo Microsoft.Office.Tools.Outlook.FormRegionName

Quando você Adicionar um item de De região de formulário do Outlook para o projeto, Ferramentas do Visual Studio para o Office define essa propriedade como o nome totalmente qualificado da região de formulário.O nome totalmente qualificado padrão é o nome do Adicionar - in conectado ao nome de região de formulário por um ponto — por exemplo, OutlookAddIn1.FormRegion1.

Esse nome totalmente qualificado também aparece como um atributo na parte superior da classe de fábrica de região de formulário.

Usar o atributo de Microsoft.Office.Tools.Outlook.FormRegionName para identificar exclusivamente a região de formulário entre Tudo Outlook Adicionar-ins.Você não pode alterar o valor do atributo Microsoft.Office.Tools.Outlook.FormRegionName , renomeando-o item de região de formulário ou alterando a propriedade FormRegionName.Para alterar esse nome, é necessário modificar o atributo Microsoft.Office.Tools.Outlook.FormRegionName no arquivo de código de região de formulário.

Desativando a herança de região de formulário

Por padrão, uma classe de mensagem Personalizar herda Tudo as associações de região de formulário da classe de mensagem base.Por exemplo, uma classe de mensagem chamada IPM.Task.Contoso deriva IPM.Task.Portanto, IPM.Task.Contoso herda as associações de região de formulário de IPM.Task.

Se você não deseja a região de formulário a ser associado a qualquer classe de mensagem derivado, defina a propriedade ExactMessageClass a região de formulário como true.Por exemplo, se você associar uma região de formulário adjacentes IPM.Task e definir a propriedade ExactMessageClass a true, a região de formulário somente será anexada à parte inferior de um formulário de tarefas padrão.A região de formulário não será anexada à parte inferior da qualquer versões personalizadas de um formulário de tarefa padrão.

Noções básicas sobre tipos e nomes de classe de mensagem

Nome de Tipo de um item do Outlook difere do nome de classe do mensagem de um item do Outlook.Por exemplo, Nome de Tipo de um item RSS é Microsoft.Office.Interop.Outlook.PostItem.O Nome de Classe de mensagem de um item RSS é IPM.Post.RSS.

Use o nome de tipo para fazer referência a um item do Outlook no código.Para obter uma lista dos nomes de tipo, consulte Associar uma região de formulário uma classe de mensagem do Outlook.

Use o Nome de Classe de mensagem dos itens do Outlook no Assistente Novo região de formulário do Outlook para associar o item com a região de formulário.Para obter uma lista de nomes de classe de mensagem válida, consulte Associar uma região de formulário uma classe de mensagem do Outlook.

Criando na adjacente regiões de formulário para o painel de leitura

Você pode usar o painel de leitura do Outlook para visualizar um item do Outlook sem Abrindo o item.O painel de leitura foi projetado para somente leitura.Portanto, controles de entrada que você adicionar a uma região de formulário adjacentes, como uma caixa de texto, podem não se comportar conforme o esperado quando a região de item e o formulário são Abrir no painel de leitura.

Por exemplo, se um item que possui um adjacentes formulário região é Abrir no painel de leitura, a seguinte situação é possível:

Selecionar um texto em uma caixa de texto que está na região de formulário.
Pressionarionar a tecla Excluir.
O item de email inteira é excluído em vez do texto na caixa de texto.

Se você estiver criando uma região de formulário adjacentes que contém controles de entrada, teste os controles no painel de leitura para garantir que eles funcionem corretamente.Considere adicionar código Personalizar que desativa a controles que não se comportarem conforme o esperado.

Como alternativa, você pode definir a propriedade ShowInspectorRead da região de formulário para False.Dessa forma, a região de formulário não pode ser usada no painel de leitura.

Usar tamanhos de ícone ideal

Você pode especificar os ícones que você deseja que a região de formulário para exibir por Configuração propriedades do ícone no AAgruparar ícones propriedade da janela de propriedades.Use as diretrizes a seguir para obter a melhor qualidade visual:

Para o Página ícone, use um arquivo PNG (Portable Network Graphics).
Ícones da janela devem ter 32 pixels por 32 pixels.
Tudo outros ícones devem ter 16 pixels por 16 pixels.

Página ícone aparece na faixa de opções de um inspetor para itens que tenham separado, substituição ou regiões de formulário de substituição-Tudo.

O ícone de janela aparece na área de notificação e em caixa de diálogo ALT+Guia para abrir itens que Exibir substituição ou regiões de formulário Substituir-Tudo.