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 objeto representa o aplicativo inteiro, o objeto representa uma pasta que contém mensagens de email ou outros itens e o ApplicationFolderMailItem 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 onde você pode aprender 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 suplemento VSTO para Outlook. Para obter mais informações, consulte Recursos disponíveis por aplicativo e tipo de projeto do Office.

Objetos do Access 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 de 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, tarefa ou 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 (UI) 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 solicitação de reunião.

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

Observação

Para ajudar a evitar avisos de segurança quando você usa propriedades e métodos que são bloqueados pelo protetor de modelo de objeto do Outlook, obtenha objetos do Outlook do campo Aplicativo da ThisAddIn classe. Para obter mais informações, consulte Considerações de segurança específicas para soluções do Office.

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 que são gerados quando a janela é alterada.

Para obter um Explorer objeto, siga um destes procedimentos:

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

• Use o ActiveExplorerApplication método do objeto para obter o Explorer que tem foco no momento.

• Use o GetExplorerFolder método do objeto para obter o Explorer para a pasta atual.

Objeto Inspector

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

Para obter um Inspector objeto, siga um destes procedimentos:

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

• Use o ActiveInspectorApplication método do objeto para obter o Inspector que tem foco no momento.

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

Objeto de pasta

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 valores de OlDefaultFolders 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 itens de pasta personalizados programaticamente.

Objeto MailItem

O MailItem objeto representa uma mensagem de email. MailItemgeralmente 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 objetos estão localizados na pasta Tarefas .

Para criar uma tarefa, use o método CreateItem do objeto e passe o valor olTaskItem para Application 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, 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 procurar 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 de assembly de interoperabilidade primária (PIA) do Outlook e a referência de modelo de objeto VBA.

Referência de assembly de interoperabilidade primária

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

Além de fornecer informações para todos os tipos nos PIAs, esta 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 VBA

A referência do modelo de objeto VBA documenta o modelo de objeto do Outlook como ele é exposto ao código do Visual Basic for Applications (VBA). Para obter mais informações, consulte Referência de modelo de objeto do Outlook 2010.

Todos os objetos e membros na referência de modelo de objeto VBA correspondem a tipos e membros no PIA do Outlook. Por exemplo, o objeto Inspector na referência do modelo de objeto VBA corresponde ao Inspector objeto no PIA do Outlook. Embora a referência de 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 nesta referência para Visual Basic ou Visual C# se desejar usá-los em um projeto de suplemento VSTO do Outlook que você cria usando o Visual Studio.

Tópicos relacionados

Título	Descrição
Trabalhar com itens de contato	Fornece tópicos que mostram como executar tarefas com contatos.
Trabalhar com itens de email	Fornece tópicos que mostram como executar tarefas com itens de email.
Trabalhar com pastas	Fornece tópicos que mostram como executar tarefas com pastas.
Trabalhar com itens de calendário	Fornece tópicos que mostram como executar tarefas com itens de calendário.
Como: determinar programaticamente o item atual do Outlook	Mostra como exibir o nome da pasta atual e algumas informações sobre o item selecionado.