Diretrizes para criação de regiões de formulário do Outlook
As informações a seguir podem ajudá-lo a otimizar suas regiões de formulário e evitar possíveis problemas:
Usando nomes de região do formulário.
Desabilitando a herança de região do formulário.
Noções básicas sobre tipos e nomes de classe de mensagem.
A criação de regiões de formulário adjacente para o painel de leitura.
Usando o ícone ideal tamanhos.
Para obter mais informações sobre regiões de 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 2007 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ões 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 elas afetam a região de formulário. A tabela a seguir descreve cada nome.
Nome da região de formulário |
Description |
|---|---|
Nome do item de região de formulário |
O nome que você especificar para o Região de formulário do Outlook item no Add New Item caixa de diálogo. Este é o nome do arquivo de código de região formulário que aparece na Solution Explorer. |
FormRegionName property |
Você especificar esse nome no fornecer texto descritivo e selecionar suas preferências de exibição página da Nova região de formulário do Outlook assistente. Esse nome aparece como o FormRegionName propriedade de Propriedades janela. Use o FormRegionName propriedade para especificar o rótulo que identifica a região de formulário na interface de usuário (UI) do Outlook. Para regiões de formulário separado, esse nome é exibido como um botão na faixa de opções do item do Outlook. Para regiões de formulário adjacente, esse nome é exibido como texto de cabeçalho acima da região de formulário. |
Microsoft.Office.Tools.Outlook.FormRegionName attribute |
Quando você adiciona um Região de formulário do Outlook item ao projeto, o Visual Studio define essa propriedade com o nome totalmente qualificado da região de formulário. O nome totalmente qualificado do padrão é o nome do suplemento conectado com o nome da 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. Use o Microsoft.Office.Tools.Outlook.FormRegionName atributo para identificar exclusivamente a região de formulário em todos os Outlook add-ins. Você não pode alterar o valor do Microsoft.Office.Tools.Outlook.FormRegionName atributo renomeando-se o item de região de formulário ou alterando a FormRegionName propriedade. Para alterar esse nome, você deve modificar o Microsoft.Office.Tools.Outlook.FormRegionName atributos no arquivo de código do formulário de região. |
Desabilitando a herança de região de formulário
Por padrão, uma classe de mensagem personalizada herda todas as associações de região de formulário da classe base de mensagem. Por exemplo, uma classe de mensagem denominada IPM.Task.Contoso deriva de IPM.Task. Portanto, IPM.Task.Contoso herda as associações de região de formulário de IPM.Task.
Se você não quiser que a região de formulário a ser associada a quaisquer classes derivadas de mensagem, defina a ExactMessageClass a propriedade da região de formulário para true. Por exemplo, se você associar uma região de formulário adjacentes com IPM.Task e defina a ExactMessageClass propriedade para true, a região de formulário só será acrescentada à parte inferior de um formulário de tarefa padrão. A região de formulário não será anexada à parte inferior de qualquer versões personalizadas de um formulário de tarefas padrão.
Noções básicas sobre tipos e nomes de classe de mensagem
O nome do tipo de item do Outlook é diferente do nome de classe de mensagem de um item do Outlook. Por exemplo, é o nome do tipo de um item RSS Microsoft.Office.Interop.Outlook.PostItem. O nome da 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 da classe de mensagem dos itens do Outlook na Nova região de formulário do Outlook para associar o item com a região de formulário. Para obter uma lista dos nomes de classe de mensagem válida, consulte Associar uma região de formulário uma classe de mensagem do Outlook.
Projetando adjacentes regiões de formulário do painel de leitura
Você pode usar o painel de leitura do Outlook para visualizar um item do Outlook sem abrir o item. O painel de leitura destina-se somente para leitura. Portanto, os controles de entrada que você adicionar a uma região de formulário adjacente, como, por exemplo, uma caixa de texto, talvez não se comportar conforme o esperado quando a região de item e o formulário estiver aberto no painel de leitura.
Por exemplo, se um item que tem uma região de formulário adjacente for aberto no painel de leitura, é possível a situação a seguir:
Selecione o texto em uma caixa de texto que está na região de formulário.
Pressione DELETE.
O item de email inteiro será excluído em vez do texto na caixa de texto.
Se você estiver criando uma região de formulário adjacente que contém controles de entrada, teste os controles no painel de leitura para garantir que eles funcionem corretamente. Considere adicionar o código personalizado que desativa os controles que não se comportar conforme o esperado.
Como alternativa, você pode definir a ShowInspectorRead a propriedade 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.
Usando os tamanhos de ícone ideal
Você pode especificar os ícones que você deseja que a região de formulário para exibir, definindo propriedades do ícone no ícones grupo de propriedade da Propriedades janela. Use as seguintes diretrizes para atingir a melhor qualidade visual:
Para o página ícone, use um arquivo Portable Network Graphics (PNG).
Janela ícones devem ser 32 pixels por 32 pixels.
Todos os outros ícones devem ser pixels de 16 por 16 pixels.
O página ícone aparece na faixa de um Inspetor para itens que tenham separado, substituição ou regiões de formulário de Substituir tudo.
O janela ícone aparece na área de notificação e, na caixa de diálogo ALT + TAB para abrir itens, exibir regiões de formulário de Substituir tudo ou substituição.
Consulte também
Tarefas
Demonstra Passo a passo: A criação de uma região de formulário do Outlook
Como: Adicionar uma região de formulário a um projeto de suplemento do Outlook
Conceitos
Acessar uma região de formulário em tempo de execução
Associar uma região de formulário uma classe de mensagem do Outlook