Compartilhar via

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

  • Artigo

Você pode especificar que os itens do Microsoft Office Outlook exibem 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 do 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 de IPM.Note .

Para associar uma região de formulário com uma classe de mensagem, especifique o nome da classe de mensagem no assistente de Novo região de formulário do Outlook ou aplicar um atributo à classe de factory da região do formulário.

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.

Classes de mensagem entendendo 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 classes de mensagem.

Tipo de item do Outlook

Nome de classe de mensagem

AppointmentItem

IPM.Appointment

ContactItem

IPM.Contact

DistListItem

IPM.DistList

JournalItem

IPM.Activity

MailItem

IPM.Note

PostItem

IPM.Post ou IPM.Post.RSS

TaskItem

IPM.Task

Você também pode especificar os nomes de classes de mensagem personalizados.as classes de mensagem personalizados identificam os formulários personalizados que você define em Outlook.

ObservaçãoObservação

Para substituição e substituir- todas as regiões de formulário, você pode especificar um novo nome de classe personalizada de mensagem.Você não precisa usar o nome da classe de mensagens de um formulário existente personalizado.O nome da classe de mensagem personalizado deve ser exclusivo.Uma maneira de garantir que o nome é exclusivo é usar uma convenção de nomenclatura semelhante ao seguinte: <StandardMessageClassName>.<Empresa>.<MessageClassName> (por exemplo: IPM.Note.Contoso.MyMessageClass).

Associando uma região de formulário com 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 da classe.

Bb157886.collapse_all(pt-br,VS.110).gifUsando o novo assistente da região de formulário do Outlook

Em a página final do assistente de Novo região de formulário do Outlook, você pode selecionar classes de mensagem padrão e digite os nomes das classes de mensagem personalizados que você deseja associar com a área do formulário.

As classes de mensagem padrão não estão disponíveis se a área do formulário é criada para substituir o formulário inteiro ou a página padrão de um formulário.Você pode especificar nomes de classe de mensagem padrão somente para os formulários que adicionam uma nova página a um formulário ou que são acrescentados à parte inferior de um formulário.Para obter mais informações, consulte Como: adicionar uma região de formulário a um projeto de suplemento do Outlook.

Para incluir uma ou mais classes de mensagem personalizados, digite seus nomes na caixa de As classes de mensagem personalizados serão exibidos essa região de formulário? .

Nomes que você digita devem estar de acordo com as seguintes diretrizes:

  • Use o nome da classe totalmente qualificado de mensagens (por exemplo: IPM.Note.Contoso “”).

  • Use ponto-e-vírgula para separar nomes de classes de vários mensagem.

  • Não inclua classes de mensagem padrão do Outlook, como “IPM.Note” ou “IPM.Contact”.Inclua somente classes de mensagem personalizados, como “IPM.Note.Contoso”.

  • Não especifique a classe de mensagem base por si só (por exemplo: IPM “”).

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

O assistente de Novo região de formulário do Outlook valida o formato da sua entrada quando você clica em Concluir.

ObservaçãoObservação

O assistente de Novo região de formulário do Outlook não verifica que os nomes de classes de mensagem que você fornece ou corretos são válidos.

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

Bb157886.collapse_all(pt-br,VS.110).gifAplicando 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 a classe de factory da região do formulário.

O exemplo a seguir mostra dois atributos de FormRegionMessageClassAttribute que foram aplicadas a uma fábrica myFormRegionchamado classe da região do formulário.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 personalizada de mensagem chamada 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 de acordo com as seguintes diretrizes:

  • Para classes de mensagem personalizados, use o nome da classe totalmente qualificado de mensagens (por exemplo: IPM.Note.Contoso “”).

  • Não especifique a classe de mensagem base por si só (por exemplo: IPM “”).

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

  • Não inclua os nomes de classes de mensagem padrão se a área do formulário substitui todo o formulário ou página padrão de um formulário.Você pode especificar nomes de classe de mensagem padrão somente para os formulários que adicionam uma nova página a um formulário ou que são acrescentados à parte inferior de um formulário.Para obter mais informações, consulte Como: adicionar uma região de formulário a um projeto de suplemento do Outlook.

O Visual Studio valida o formato de nomes de classe de mensagem quando você criar o projeto.

ObservaçãoObservação

Visual Studio não verifica que os nomes de classes de mensagem que você fornece ou corretos são válidos.

Consulte também

Tarefas

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

Referência

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

Como Outlook forma e os itens funcionam juntos

Conceitos

Acessando 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