Visão geral sobre o modelo de objeto do Outlook

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

Este tópico fornece uma breve visão geral sobre alguns dos objetos principais no modelo de objeto do Outlook.Para recursos onde você pode aprender mais sobre o modelo de objeto inteiro do Outlook, consulte Usando a documentação do modelo de objeto do Outlook.

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.

Para uma demonstração de vídeo relacionada, consulte Como: eu faço Use Outlook para criar um relatório de tarefa personalizada?.

Acessando objetos em um projeto do Outlook

Outlook fornece vários objetos COM que você pode interagir.Para usar efetivamente o modelo de objeto, você deve estar familiarizado com os seguintes objetos de alto nível:

• Application

• Explorer

• Inspector

• MAPIFolder

• MailItem

• AppointmentItem

• TaskItem

• ContactItem

Objeto de aplicativo

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

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

• A propriedade de Explorers , que você pode usar para acessar o windows que exibe o conteúdo de uma pasta na interface de usuário (UI) do Outlook.

• A propriedade de Inspectors , que você pode usar para acessar o windows que exibe 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 objeto de Application , use o campo de Application da classe de ThisAddIn em seu projeto.Para obter mais informações, consulte Os suplementos de nível de aplicativo de programação..

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

objeto de Explorer

O objeto de Explorer representa uma janela que exibe o conteúdo de uma pasta que contém itens como mensagens de email, tarefas, ou nomeações.O objeto de Explorer inclui os métodos e propriedades que você pode usar para alterar a janela, e eventos que são gerados quando a janela for alterado.

Para obter um objeto de Explorer , siga um de estes procedimentos:

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

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

• Use o método de GetExplorer do objeto de MAPIFolder para obter Explorer para a pasta atual.

Objeto de inspector

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

Para obter um objeto de Inspector , siga um de estes procedimentos:

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

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

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

objeto de MAPIFolder

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

Os objetos de MAPIFolder de opção são definidos pelos valores de enumeração de OlDefaultFolders .Por exemplo,

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

Para um exemplo que mostra como acessar uma opção MAPIFolder e para criar uma nova MAPIFolder, consulte Como criar itens de pasta personalizados programaticamente.

objeto de MailItem

o objeto de MailItem representa uma mensagem de email.os objetos deMailItem são geralmente nas 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 um exemplo que mostra como criar uma mensagem de email, consulte Como criar um item de email programaticamente.

objeto de AppointmentItem

O objeto de AppointmentItem representa uma reunião, uma única nomeação, ou uma nomeação de retorno ou o encontro na pasta de Calendário .O objeto de AppointmentItem inclui os métodos que a executar ações como a resposta ou encaminhar solicitações de reunião, e propriedades que especificam detalhes de reunião como o local e hora.

Para um exemplo que mostra como criar uma nomeação, considere Como criar uma solicitação de reunião programaticamente.

objeto de TaskItem

o objeto de TaskItem representa uma tarefa ser executado dentro de um prazo especificado.os objetos deTaskItem estão localizados na pasta de Tarefas .

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

objeto de ContactItem

O objetode ContactItemrepresenta um contato na pasta de Contatos .os objetos deContactItem contém uma variedade de informações de contato para pessoas que representam endereços, como, endereços de email, e números de telefone.

Para um exemplo que mostra como criar um novo contato, considere Como adicionar uma entrada a contatos do Outlook programaticamente.Para um exemplo que mostra como procurar por um contato existente, considere Como procurar um contato específico programaticamente.

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

Para obter informações completas sobre o modelo de objeto do Outlook, você pode referir-se a referência primária de (PIA) do assembly de interoperabilidade do Outlook e a referência de modelos de objeto de VBA.

Referência do assembly de Interoperabilidade primária

Documentos de referência de PIA do Outlook os tipos em assemblies de interoperabilidade primários para Outlook 2010.Para obter mais informações, consulte Referência do assembly principal do Outlook 2010 Interoperabilidade.

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

Referência de modelos de objeto de VBA

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

Todos os objetos e membros na referência de modelos de objeto de VBA correspondem aos tipos e membros na PIA do Outlook.Por exemplo, o objeto de Inspector na referência de modelos de objeto de VBA corresponde ao objeto de Microsoft.Office.Interop.Outlook.Inspector no PIA do Outlook.Embora a referência de modelos de objeto de VBA fornece exemplos de código para a maioria, propriedades, métodos e eventos, você deve converter o código de VBA em essa referência ao Visual Basic ou visual C# se você deseja usá-los em um projeto do suplemento ao Outlook que você cria usando Visual Studio.

Tópicos relacionados