Diretrizes para criação de regiões de formulário do Outlook

As informações a seguir ajudará a otimizar as regiões do formulário e a evitar possíveis problemas:

  • Usando nomes de região de formulário.

  • Desabilitando a herança de região de formulário.

  • Tipos e nomes de classe de mensagem entendendo.

  • Criar regiões adjacentes do formulário para o painel de leitura.

  • Usando tamanhos melhores de ícone.

Para obter mais informações sobre as regiões do formulário, consulte Criação de regiões de formulário do Outlook.

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.

Usando nomes de região de formulário

Há vários nomes usados para descrever a área do formulário.É importante entender a diferença entre esses nomes e como elas afetam a área do formulário.A tabela a seguir descreve cada nome.

Nome da área do formulário

Descrição

Nome do item da região de formulário

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 .Este é o nome do arquivo de código de área do formulário que aparece em Gerenciador de Soluções.

Propriedade FormRegionName

Você especifica o nome de Forneça texto descritivo e selecione suas preferências de exibição na página do assistente de Novo região de formulário do Outlook .Este nome aparece como a propriedade de FormRegionName na janela de Propriedades .

Use a propriedade de FormRegionName para especificar o rótulo que identifica a região de formulário na interface de usuário (UI) do Outlook.Para regiões separadas do formulário, esse nome aparece como um botão em fita de item do Outlook.

Para regiões adjacentes do formulário, esse nome é exibido como o texto do cabeçalho acima da área do formulário.

Atributo Microsoft.Office.Tools.Outlook.FormRegionName

Quando você adiciona um item de Região do Formulário do Outlook ao projeto, o Visual Studio define essa propriedade como o nome totalmente qualificado da área do formulário.O nome totalmente qualificado padrão é o nome do suplemento conectado ao nome da região de formulário por com ponto para o exemplo, OutlookAddIn1.FormRegion1.

Este nome totalmente qualificado também aparece como um atributo na parte superior da classe de factory da região do formulário.

Use o atributo de Microsoft.Office.Tools.Outlook.FormRegionName para identificar exclusivamente a região de formulário por meio de qualquer suplementos do Outlook.Você não pode alterar o valor do atributo de Microsoft.Office.Tools.Outlook.FormRegionName renomeando o item de região de formulário ou alterando a propriedade de FormRegionName .Para alterar esse nome, você deve alterar o atributo de Microsoft.Office.Tools.Outlook.FormRegionName no arquivo de código de área do formulário.

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

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

Se você não quiser a região de formulário a serem associados com nenhuma classe derivada de mensagem, defina a propriedade de ExactMessageClass da região da trueformulário.Por exemplo, se você associa uma região adjacente do formulário com IPM.Task e defina a propriedade de ExactMessageClass a true, a região de formulário será acrescentada somente a parte inferior de um formulário padrão de tarefas.A área do formulário não será acrescentada para a parte inferior das versões personalizado de um formulário padrão de tarefas.

Tipos e nomes de classe de mensagem entendendo

O nome do tipo de um item do Outlook difere do nome da classe de mensagens de um item do Outlook.Por exemplo, o nome do tipo de um item de alimentação é Microsoft.Office.Interop.Outlook.PostItem.O nome da classe de mensagens de um item de alimentação é IPM.Post.RSS.

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

Use o nome da classe de mensagem de itens do Outlook no assistente de Novo região de formulário do Outlook para associar o item com a área do formulário.Para obter uma lista de nomes de classe válido de mensagem, consulte A associação de uma região de formulário com uma classe de mensagem do Outlook.

Criar regiões adjacentes do formulário para o painel de leitura

Você pode usar Outlook que lê o painel para visualizar um item do Outlook sem abrir o item.O painel de ler somente leitura é criado.Portanto, os controles de entrada que você adiciona a uma região adjacente de formulário, como uma caixa de texto, pode não se comportar conforme o esperado quando a região de item e do formulário é aberta no painel de leitura.

Por exemplo, se um item que tem uma região adjacente do formulário é aberto no painel de leitura, a situação é possível seguinte:

  1. Selecione um texto em uma caixa de texto que está na região do formulário.

  2. Pressione DELETE o.

  3. O item inteiro de email é excluído em vez de texto na caixa de texto.

Se você estiver criando uma região adjacente do formulário que contém controles de entrada, testar os controles no painel de leitura para garantir que funcionem corretamente.Considere adicionar o código personalizado que desativa os controles que não se comportam como esperado.

Como alternativa, você pode definir a propriedade de ShowInspectorRead da região da Falseformulário.Essa maneira a região de formulário não pode ser usada no painel de leitura.

Usando tamanhos melhores de ícone

Você pode especificar que os ícones você deseja a área do formulário para exibir definindo propriedades de ícone no grupo de propriedade de Ícones da janela de Propriedades .Use as seguintes diretrizes para obter melhor qualidade visual:

  • Para o ícone de Página , use um arquivo de (PNG) de formato PNG.

  • ícones deJanela devem ser 32 pixels por 32 pixels.

  • Todos ícones restantes devem ser 16 pixels por 16 pixels.

O ícone de Página aparece em fita de um inspector para itens que têm separado, a substituição, ou substituir- todas as regiões do formulário.

O ícone de Janela aparece na área de notificação e na caixa de diálogo ALT+TAB para abrir itens que exibem a substituição ou substituir- todas as regiões do formulário.

Consulte também

Tarefas

Passo a passo: Criando uma região de formulário do Outlook

Como: adicionar uma região de formulário a um projeto de suplemento do Outlook

Conceitos

Acessando uma região de formulário em tempo de execução

A associação de uma região de formulário com uma classe de mensagem do Outlook

Outros recursos

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