Associar uma região de formulário uma classe de mensagem do Outlook

Você pode especificar quais itens do Microsoft Office Outlook Exibir uma região de formulário associando a região de formulário com a classe de mensagem de cada item.Por exemplo, se você quiser acrescentar uma região de formulário para a parte inferior de um item de email, você pode associar a região de formulário com a classe de mensagem IPM.Note.

Para associar uma região de formulário com uma classe de mensagem, especificar o Nome de Classe de mensagem no Assistente Novo região de formulário do Outlook ou aplicar um atributo para a classe de fábrica de região de formulário.

Noções básicas sobre classes de mensagem do Outlook

Uma classe de mensagem do Outlook identifica um tipo de item do Outlook.A tabela a seguir lista esses oito tipos de padrão de itens e seus nomes de classe de mensagem.

Você também pode especificar os nomes das classes de mensagem Personalizar.Classes de mensagem Personalizar identificam formulários Personalizars que você Definir no Outlook.

Observação:

Para substituição e regiões de formulário Substituir-tudo, você pode especificar um novo nome de classe de mensagem Personalizar.Você não precisará usar o nome de classe de mensagem de um formulário Personalizar existente.O nome da classe de mensagem Personalizar deve ser exclusivo.Uma maneira para garantir que o nome é cancelar ique é usar uma convenção de nomes semelhante à seguinte: < StandardMessageClassName>. <empresa>. <MessageClassName > (por exemplo: IPM.Anotação.Contoso.MyMessageClass).

Associar uma região de formulário uma classe de mensagem do Outlook

Há duas maneiras para associar uma região de formulário com uma classe de mensagem:

• Use o Assistente de Novo região de formulário do Outlook.

• Aplicar atributos de classe.

Usar o novo Assistente de região de formulário do Outlook

Na página final do assistente Novo região de formulário do Outlook, você pode selecionar classes de mensagens padrão e tipo os nomes das classes de mensagem Personalizar que você deseja associar a região de formulário.

As classes de mensagem padrão não estarão disponíveis se a região de formulário foi projetada para substituir todo o formulário ou a página de padrão de um formulário.Você pode especificar nomes de classe mensagem padrão somente para formulários que adicionar um Novo Página para um formulário ou que são acrescentados à parte inferior de um formulário.For more information, see Como: Adicionar uma região de formulário a um projeto de suplemento do Outlook.

Para incluir um ou mais classes de mensagem Personalizar, digite seus nomes no Qual mensagem Personalizar classes serão Exibir essa região de formulário? caixa.

Os nomes que você tipo deve cumprir as diretrizes a seguir:

• Usar o nome de classe mensagem totalmente qualificado (por exemplo: "IPM.Anotação.Contoso").

• Use ponto-e-vírgula para separar Múltiplo nomes de classe de mensagem.

• Não Incluir classes de mensagem padrão do Outlook, tais como "IPM.Anotação" ou "IPM.Contato".Incluir somente as classes de mensagem Personalizar, tais como "IPM.Anotação.Contoso".

• Não especificar a classe de mensagem base por si só (por exemplo: "IPM").

• Não exceda 256 caracteres para cada nome de classe de mensagem.

O Assistente de Novo região de formulário do Outlook valida o Formatarar de sua entrada quando você Clique Concluir.

Observação:
O Novo assistente de de região de formulário do Outlook não verifique se os nomes de classe de mensagem que você fornecer estão corretos ou é válido.

Quando você concluir o assistente, o Assistente de Novo região de formulário do Outlook se aplica atributos à classe de região de formulário que contêm os nomes de classe de mensagem especificado.Você também pode aplicar esses atributos manualmente.

Aplicando atributos de classe

Você pode associar uma região de formulário com uma classe de mensagem do Outlook depois que você concluir o Assistente de Novo região de formulário do Outlook.Para fazer isso, aplicar atributos para a classe de fábrica de região de formulário.

O exemplo a seguir mostra dois atributos de FormRegionMessageClassAttribute que tenham sido aplicados a uma classe de fábrica de região de formulário chamada myFormRegion.O primeiro atributo associa a região de formulário com uma classe de mensagem padrão para um formulário de mensagem de email.O segundo atributo associa a região de formulário com uma classe de mensagem Personalizar denominada IPM.Task.Contoso.

<Microsoft.Office.Tools.Outlook.FormRegionMessageClass(Microsoft.Office.Tools.Outlook.FormRegionMessageClassAttribute.Note)> _
<Microsoft.Office.Tools.Outlook.FormRegionMessageClass("IPM.Task.Contoso")> _
<Microsoft.Office.Tools.Outlook.FormRegionName("Trin_Outlook_FR_Attributes.FormRegion1")> _
Partial Public Class FormRegion1Factory

' Occurs before the form region is initialized.
' To prevent the form region from appearing, set e.Cancel to true.
' Use e.OutlookItem to get a reference to the current Outlook item.
    Private Sub FormRegion1Factory_FormRegionInitializing(ByVal sender As Object, ByVal e As Microsoft.Office.Tools.Outlook.FormRegionInitializingEventArgs) Handles Me.FormRegionInitializing

End Sub

[Microsoft.Office.Tools.Outlook.FormRegionMessageClass
    (Microsoft.Office.Tools.Outlook.FormRegionMessageClassAttribute.Note)]
[Microsoft.Office.Tools.Outlook.FormRegionMessageClass
    ("IPM.Task.Contoso")]
[Microsoft.Office.Tools.Outlook.FormRegionName
    ("Trin_Outlook_FR_Attributes.FormRegion1")]
public partial class FormRegion1Factory
{
    // Occurs before the form region is initialized.
    // To prevent the form region from appearing, set e.Cancel to true.
    // Use e.OutlookItem to get a reference to the current Outlook item.
    private void FormRegion1Factory_FormRegionInitializing(object sender, 
        Microsoft.Office.Tools.Outlook.FormRegionInitializingEventArgs e)
    {
    }
}

Atributos devem cumprir as diretrizes a seguir:

• Para classes de mensagem Personalizar, usar o nome de classe de mensagem totalmente qualificado (por exemplo: "IPM.Anotação.Contoso").

• Não especificar a classe de mensagem base por si só (por exemplo: "IPM").

• Não exceda 256 caracteres para cada nome de classe de mensagem.

• Não Incluir os nomes das classes de mensagem padrão se a região de formulário substituir todo o formulário ou a página de padrão de um formulário.Você pode especificar nomes de classe mensagem padrão somente para formulários que adicionar um Novo Página para um formulário ou que são acrescentados à parte inferior de um formulário.For more information, see Como: Adicionar uma região de formulário a um projeto de suplemento do Outlook.

Ferramentas do Visual Studio para o Office valida o Formatarar da mensagem de nomes de classe quando você Compilação o projeto.

Observação:
Ferramentas do Visual Studio para o Office não verifique se os nomes de classe de mensagem que você fornecer estão corretos ou é válido.

Consulte também

Tarefas

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

Conceitos

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

Criar regiões de formulário do Outlook

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

Referência

Sobre a classe de nome e a mensagem do formulário

Como os formulários do Outlook e itens funcionam juntos