Compartilhar via

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

  • Artigo

Você pode especificar quais itens de Microsoft Office Outlook exibem uma região de formulário, associando-se 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 o IPM.Note classe de mensagem.

Para associar uma região de formulário uma classe de mensagem, especifique o nome de classe de mensagem na Nova região de formulário do Outlook assistente ou aplicar um atributo para a classe de fábrica da região de formulário.

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.

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 padrão de itens e seus nomes de classe da mensagem.

Tipo de Item do Outlook

Nome da classe de mensagem

AppointmentItem

IPM.Compromisso

ContactItem

IPM.Contato

DistListItem

IPM.DistList

JournalItem

IPM.Atividade

MailItem

IPM.Observação

PostItem

IPM.POST ou IPM.POST.RSS

TaskItem

IPM.Tarefa

Você também pode especificar os nomes das classes de mensagem personalizada. Classes de mensagem personalizada identificam formulários personalizados que você define no Outlook.

ObservaçãoObservação

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

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

Há duas maneiras de se associar a uma classe de mensagem de uma região de formulário:

  • Use o Nova região de formulário do Outlook assistente.

  • Aplica atributos de classe.

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

Na página final da Nova região de formulário do Outlook assistente, você pode selecionar classes de mensagem padrão e digite os nomes das classes de mensagem personalizada que você deseja associar a região de formulário.

As classes de mensagem padrão não estão disponíveis se a região de formulário é projetada para substituir todo o formulário ou página de um formulário padrão. Você pode especificar nomes de classe de mensagem padrão somente para formulários que adicionar uma nova página a 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 uma ou mais classes de mensagem personalizada, digite seus nomes na quais classes de mensagem personalizada exibirá a região de formulário? caixa.

Os nomes que você digita devem estar em conformidade com as diretrizes a seguir:

  • Use o nome de classe totalmente qualificado de mensagem (por exemplo: "IPM.Note.contoso").

  • Utilize ponto e vírgula para separar vários nomes de classe da mensagem.

  • Não inclua padrão classes de mensagem do Outlook, como, por exemplo, "IPM.Observação" ou "IPM.Entre em contato". Incluir somente as classes de mensagem personalizada, como, por exemplo, "IPM.Note.contoso".

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

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

O Nova região de formulário do Outlook Assistente valida o formato de entrada quando você clica em Concluir.

ObservaçãoObservação

O Nova região de formulário do Outlook assistente não verifica se os nomes de classe de mensagem que você fornecer estão corretos ou válido.

Quando você concluir o assistente, o Nova região de formulário do Outlook assistente aplica os atributos para a classe de região de formulário que contêm os nomes de classe de mensagem especificada. 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 de concluir o Nova região de formulário do Outlook assistente. Para fazer isso, aplique atributos para a classe de fábrica da região de formulário.

O exemplo a seguir mostra dois FormRegionMessageClassAttribute atributos que foram aplicados a uma classe de fábrica da região de formulário chamada myFormRegion. O primeiro atributo associa a região de formulário uma classe de mensagem padrão para um formulário de mensagem de email. O segundo atributo associa a região de formulário uma classe de mensagem personalizada 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 estar em conformidade com as diretrizes a seguir:

  • Para classes de mensagem personalizada, use o nome de classe totalmente qualificado de mensagem (por exemplo: "IPM.Note.contoso").

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

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

  • Não inclua os nomes das classes de mensagem padrão se a região de formulário substitui todo o formulário ou página de um formulário padrão. Você pode especificar nomes de classe de mensagem padrão somente para formulários que adicionar uma nova página a 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.

Visual Studio valida o formato dos nomes de classe de mensagem quando você constrói o projeto.

ObservaçãoObservação

Visual Studio não verifica se os nomes de classe de mensagem que você fornecer estão corretos ou válido.

Consulte também

Tarefas

Demonstra Passo a passo: A criação de uma região de formulário do Outlook

Referência

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

Como os itens e formulários do Outlook funcionam juntos

Conceitos

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

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

Outros recursos

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