Visão geral do modelo de objeto do Outlook

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

Este tópico fornece uma 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 usando a documentação de 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 2007 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 Fazer como i: Usar o Outlook para criar um relatório de tarefas personalizado?.

Acessando objetos em um projeto do Outlook

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

• Application

• Explorer

• Inspector

• MAPIFolder

• MailItem

• AppointmentItem

• TaskItem

• ContactItem

Objeto de aplicativo

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

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

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

• O 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 da Application de objeto, use o Application campo de ThisAddIn classe no projeto. For more information, see Os suplementos de nível de aplicativo de programação..

Observação
Para ajudar a evitar os avisos de segurança ao usar propriedades e métodos que são bloqueados pelo object model guard do Outlook, obter a partir de objetos do Outlook a Application campo de ThisAddIn classe. For more information, see 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 alterações window.

Para obter um Explorer de objeto, faça o seguinte:

• Uso o Explorers propriedade da Application objeto para acessar todas as Explorer objetos no Outlook.

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

• Use o GetExplorer método o MAPIFolder 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 alterações window.

Para obter um Inspector de objeto, faça o seguinte:

• Uso o Inspectors propriedade da Application objeto para acessar todas as Inspector objetos no Outlook.

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

• Use o GetInspector do método de um determinado item, como um MailItem ou AppointmentItem, para recuperar o Inspetor que está associado com o proprietário.

Objeto MAPIFolder

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

O padrão MAPIFolder objetos são definidos pelo OlDefaultFolders valores de enumeração. For example,

Microsoft.Office.Interop.Outlook.OlDefaultFolders.olFolderInboxcorresponde do caixa de entrada pasta do Outlook.

Para obter um exemplo que mostra como acessar um padrão MAPIFolder e criar um novo MAPIFolder, consulte Como: Criar itens de pasta personalizada.

Objeto MailItem

O MailItem objeto representa uma mensagem de email. MailItemobjetos são normalmente em pastas, como caixa de entrada, Itens enviados, e caixa de saída. MailItemexpõ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 um Item de email.

Objeto AppointmentItem

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

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

Objeto TaskItem

O TaskItem objeto representa uma tarefa a ser executada em um intervalo de tempo especificado. TaskItemos objetos estão localizados na tarefas pasta.

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

Objeto ContactItem

O ContactItemobjeto representa um contato a contatos pasta. ContactItemos objetos contêm uma variedade de informações de contato para as pessoas que eles representam, como, por exemplo, 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 uma entrada para os contatos do Outlook. Para obter um exemplo que mostra como procurar um contato existente, consulte Como: Procurar um contato específico..

Usando a documentação de 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 do VBA.

Referência de Assembly de interoperabilidade primária

A referência de PIA do Outlook documenta os tipos de assemblies de interoperabilidade primária para 2010 do Outlook e Outlook 2007. Esta documentação está disponível nos seguintes locais:

• Referência de Assembly de interoperabilidade do Outlook 2010 primário

• Referência de Assembly de interoperabilidade do Outlook 2007 primário

Para além de fornecer informações para todos os tipos dos 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 de modelo de objeto do VBA

Os VBA objeto modelo documentos de referência o modelo de objeto do Outlook como ele é exposto para Visual Basic for Applications o código VBA (). A referência de modelo de objeto do VBA para o Outlook está disponível nos seguintes locais:

• Referência de modelo de objeto do Outlook 2010

• Referência de modelo de objeto do Outlook 2007

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

Related Topics

Histórico de alterações