Visão geral do modelo de objeto do Outlook

Para desenvolver suplementos VSTO para o Microsoft Office Outlook, você pode interagir com os objetos fornecidos pelo modelo de objeto do Outlook. O modelo de objeto do Outlook fornece classes e interfaces que representam itens na interface do usuário. Por exemplo, o Application objeto representa todo o aplicativo, o Folder objeto representa uma pasta que contém mensagens de email ou outros itens e o MailItem objeto representa uma mensagem de email.

Este tópico fornece uma breve visão geral de alguns dos principais objetos no modelo de objeto do Outlook. Para obter recursos em que você pode saber mais sobre todo o modelo de objeto do Outlook, consulte Usar a documentação do modelo de objeto do Outlook.

Aplica-se a: As informações neste tópico se aplicam a projetos de Suplementos VSTO para Outlook. Para obter mais informações, consulte Os recursos disponíveis pelo aplicativo do Office e pelo tipo de projeto.

Acessar objetos em um projeto do Outlook

O Outlook fornece muitos objetos com os quais você pode interagir. Para usar o modelo de objeto com eficiência, você deve estar familiarizado com os seguintes objetos de nível superior:

• Application

• Explorer

• Inspector

• Folder

• MailItem

• AppointmentItem

• TaskItem

• ContactItem

Objeto Aplicativo

O Application objeto representa o aplicativo outlook e é o objeto de nível mais alto no modelo de objeto do Outlook. Alguns dos membros mais importantes deste objeto incluem:

• O método CreateItem que você pode usar para criar um novo item, como uma mensagem de email, uma tarefa ou um compromisso.

• A Explorers propriedade, que você pode usar para acessar as janelas que exibem o conteúdo de uma pasta na interface do usuário do Outlook.

• A Inspectors propriedade, que você pode usar para acessar as janelas que exibem o conteúdo de um único item, como uma mensagem de email ou uma solicitação de reunião.

  Para obter uma instância do Application objeto, use o campo Aplicativo da ThisAddIn classe em seu projeto. Para obter mais informações, consulte Complementos do Programa VSTO.

Objeto Explorer

O Explorer objeto representa uma janela que exibe o conteúdo de uma pasta que contém itens como mensagens de email, tarefas ou compromissos. O Explorer objeto inclui métodos e propriedades que você pode usar para modificar a janela e eventos gerados quando a janela é alterada.

Para obter um Explorer objeto, siga um destes procedimentos:

• Use a Explorers propriedade do Application objeto para acessar todos os Explorer objetos no Outlook.

• Use o método ActiveExplorer do objeto Application para obter o Explorer que atualmente tem foco.

• Use o método GetExplorer do objeto Folder para obter o Explorer da pasta atual.

Objeto Inspector

O Inspector objeto representa uma janela que exibe um único item, como uma mensagem de email, uma tarefa ou um compromisso. O Inspector objeto inclui métodos e propriedades que você pode usar para modificar a janela e eventos gerados quando a janela é alterada.

Para obter um Inspector objeto, siga um destes procedimentos:

• Use a Inspectors propriedade do Application objeto para acessar todos os Inspector objetos no Outlook.

• Use o método ActiveInspector do objeto Application para obter o Inspector que atualmente tem foco.

• Use o método GetInspector de um item específico, como um MailItem ou AppointmentItem, para recuperar o inspetor associado a ele.

Objeto Folder

O Folder objeto representa uma pasta que contém mensagens de email, contatos, tarefas e outros itens. O Outlook fornece 16 objetos padrão Folder .

Os objetos padrão Folder são definidos pelos OlDefaultFolders valores de enumeração. Por exemplo

Microsoft.Office.Interop.Outlook.OlDefaultFolders.olFolderInbox corresponde à pasta Caixa de Entrada no Outlook.

Para obter um exemplo que mostra como acessar um padrão Folder e criar um novo Folder, consulte Como criar programaticamente itens de pasta personalizados.

Objeto MailItem

O MailItem objeto representa uma mensagem de email. MailItem os objetos geralmente estão em pastas, como Caixa de Entrada, Itens Enviados e Caixa de Saída. MailItem expõe propriedades e métodos que podem ser usados para criar e enviar mensagens de email.

Para obter um exemplo que mostra como criar uma mensagem de email, consulte Como criar programaticamente um item de email.

Objeto AppointmentItem

O AppointmentItem objeto representa uma reunião, um compromisso único ou um compromisso ou reunião recorrente na pasta Calendário . O AppointmentItem objeto inclui métodos que executam ações como responder ou encaminhar solicitações de reunião e propriedades que especificam detalhes da reunião, como o local e a hora.

Para obter um exemplo que mostra como criar um compromisso, consulte Como criar programaticamente uma solicitação de reunião.

Objeto TaskItem

O TaskItem objeto representa uma tarefa a ser executada dentro de um período de tempo especificado. TaskItem os objetos estão localizados na pasta Tarefas .

Para criar uma tarefa, use o método CreateItem do Application objeto e passe o valor olTaskItem para o parâmetro.

Objeto ContactItem

O ContactItemobjeto representa um contato na pasta Contatos . ContactItem os objetos contêm uma variedade de informações de contato para as pessoas que representam, como endereços de rua, endereços de email e números de telefone.

Para obter um exemplo que mostra como criar um novo contato, consulte Como adicionar programaticamente uma entrada aos contatos do Outlook. Para obter um exemplo que mostra como pesquisar um contato existente, consulte Como pesquisar programaticamente um contato específico.

Usar a documentação do modelo de objeto do Outlook

Para obter informações completas sobre o modelo de objeto do Outlook, você pode consultar a referência da assembly de interoperabilidade primária do Outlook (PIA) e a referência do modelo de objeto do VBA (Visual Basic for Applications).

Referência de assembly de interoperabilidade primário

A referência do Outlook PIA documenta os tipos nos assemblies de interoperabilidade primários do Outlook 2010. Para obter mais informações, consulte a referência de assembly de interoperabilidade primária do Outlook 2010.

Além de fornecer informações para todos os tipos nos PIAs, essa documentação também fornece informações adicionais sobre a estrutura dos PIAs e exemplos de código para tarefas comuns de automação do Outlook.

Referência do modelo de objeto do VBA

O modelo de objeto VBA faz referência ao modelo de objeto do Outlook, pois ele é exposto ao código do VBA (Visual Basic for Applications). Para obter mais informações, consulte a referência do modelo de objeto do Outlook 2010.

Todos os objetos e membros na referência do modelo de objeto do VBA correspondem a tipos e membros no Outlook PIA. Por exemplo, o objeto Inspector na referência do modelo de objeto do VBA corresponde ao objeto Inspector no Outlook PIA. Embora a referência do modelo de objeto VBA forneça exemplos de código para a maioria das propriedades, métodos e eventos, você deve traduzir o código VBA nessa referência para Visual Basic ou Visual C# se quiser usá-los em um projeto de Add-In do Outlook VSTO criado usando o Visual Studio.

Tópicos relacionados