OL97: Exemplos de programação para pastas e itens de referência

O modelo de objeto do Microsoft Outlook 97 é normalmente usado para acessar vários tipos de itens em pastas. Este artigo fornece uma visão geral dos vários métodos, propriedades e objetos que podem ser usados para se referir a itens do Outlook e pastas.

Este artigo resume os tópicos a seguir:

• Método GetDefaultFolder
• Objeto Folders
• Propriedade pai
• Método GetSharedDefaultFolder
• Método GetFolderFromID

• Método Folders.Add

• Método CreateItem
• Método Items.Add
• Método CreateItemFromTemplate

• Usar itens (i) ou for each... Next
• Uso de itens ("Este é o assunto")
• Localizar método
• Restringir o método

Microsoft fornece exemplos de programação apenas para ilustração, sem garantia expressa ou implícita, incluindo, mas não se limitando às garantias implícitas de comercialização e/ou adequação a uma finalidade específica. Este artigo presume que você esteja familiarizado com a linguagem de programação demonstrada e as ferramentas usadas para criar e depurar procedimentos. Profissionais de suporte da Microsoft podem ajudar a explicar a funcionalidade de um determinado procedimento, mas eles não modificarão esses exemplos para fornecer funcionalidades adicionais ou construir procedimentos para atender às suas necessidades específicas.
Se você não tenha muita experiência de programação, talvez queira em contato com um Microsoft Certified Partner ou Microsoft Advisory Services. Para obter mais informações, visite da Microsoft:

Microsoft Certified Partners - https://partner.microsoft.com/global/30000104 (https://partner.microsoft.com/global/30000104)

Comunicado de Microsoft Services - http://support.microsoft.com/gp/advisoryservice (http://support.microsoft.com/gp/advisoryservice)

Para obter mais informações sobre as opções de suporte estão disponíveis e sobre como entrar em contato com a Microsoft, visite o seguinte site: http://support.microsoft.com/default.aspx?scid=fh;EN-US;CNTACTMS (http://support.microsoft.com/default.aspx?scid=fh;en-us;cntactms) Observação: O código do Visual Basic Scripting Edition (VBScript) deve usar o valor numérico das constantes definidas na biblioteca de objeto do Outlook. Você pode localizar uma listagem desses valores no arquivo de Ajuda de biblioteca de objeto do Microsoft Outlook (Vbaoutl.hlp) sob o tópico "Microsoft Outlook constantes".

Referenciar pastas existentes

Método GetDefaultFolder:

Pastas padrão são aquelas que estão no mesmo nível que a caixa de entrada que recebe mensagens de entrada. Se você tiver mais de uma caixa de entrada em seu perfil, pressionar as teclas CTRL+SHIFT + I sempre seleciona a caixa de entrada padrão. As pastas padrão são aquelas que a maioria dos usuários trabalhar com em uma base regular, como as pastas Calendário, contatos e tarefas. Você pode facilmente referir-se a essas pastas usando o método GetDefaultFolder. GetDefaultFolder tem um argumento, que é o tipo de pasta que você deseja se referir. Os exemplos a seguir atribuir a variável de objeto MinhaPasta a pasta padrão Contatos: pastas objeto: você pode usar o objeto Folders para fazer referência a qualquer pasta que está visível na lista de pasta do Outlook. Esse objeto é normalmente usado para se referir a uma pasta pública do Exchange ou qualquer outra pasta que não é uma pasta predefinida do Outlook.

Os exemplos a seguintes ilustram como para se referir a uma pasta pública chamada "Minha pasta pública". Observe que você normalmente iniciar na pasta superior e funciona sua forma até a pasta que você precisa fazer referência. Observe também que os nomes de pastas fazem distinção entre maiúsculas e minúsculas e devem corresponder exatamente os nomes que aparecem na lista de pasta do Outlook. os exemplos a seguintes ilustram como você pode se referir a uma pasta chamada "Tarefas de Business", que é uma subpasta da pasta padrão tarefas. propriedade pai:

Se você já tiver uma referência a uma pasta ou um item do Outlook, em seguida, você pode usar sua propriedade pai para criar uma referência para a pasta o item ou pasta está localizada em.

Os exemplos a seguir retornam o nome de uma pasta para um determinado item: GetSharedDefaultFolder:

Você pode usar esse método se alguém tenha dado a você delegar permissões para uma das suas pastas padrão. Além disso, você deve ter já conectado para a pasta no Outlook clicando no menu Arquivo, clicando em Abrir pasta especial, e clicando em pasta do Exchange Server.

Para obter mais informações sobre como acessar as pastas de outras pessoas, consulte o seguinte artigo na Base de dados de Conhecimento da Microsoft: Depois que Outlook é configurado para usar outra pessoa pasta, GetSharedDefaultFolder método é usado da mesma maneira como GetDefaultFolder, exceto que você especificar um argumento adicional--o nome da pasta da outra pessoa você deseja referenciar. Este exemplo primeiro resolve nome da outra pessoa para verificar se ele é um nome válido que pode ser usado com o método GetSharedDefaultFolder. GetFolderFromID:

Este método geralmente seria usado em soluções mais complexas onde uma solução mantém controle sobre a StoreID e EntryID de uma pasta para que ele pode ser referenciado rapidamente posteriormente.

Para obter mais informações sobre como usar o método GetFolderFromID, consulte o seguinte artigo na Base de dados de Conhecimento da Microsoft:

Criar e referenciar novas pastas

Método Folders.Add:

Usando o método Add no conjunto de pastas permite que você crie uma nova pasta. O primeiro argumento especifica o nome da pasta e o segundo argumento especifica o tipo da pasta. O exemplo a seguir adiciona uma pasta Business tarefas sob a pasta de tarefas padrão. Porque o tipo de pasta não for especificado, ele irá herdar o tipo da pasta pai.

Criar e referenciar novos itens

Método CreateItem:

O método CreateItem cria um novo item do Outlook padrão. Se você precisar criar um item com base em um formulário personalizado que você criou, use o método Items.Add abaixo. O método CreateItem é convenientemente localizado fora do objeto aplicativo de nível superior no modelo de objeto do Outlook. O método tem apenas um argumento, uma constante indicando o tipo de item para criar. método Items.Add:

Usando o método Add na coleção Items permite que você criar um novo item com base em qualquer classe de mensagem, seja uma classe de mensagem do Outlook padrão como IPM.contato ou uma classe de mensagem para um formulário personalizado, como IPM.contato.MeuFormulário. Para usar o método Items.Add, primeiro você deve fazer referência a pasta onde você deseja criar um novo item.

Para obter mais informações sobre classes de mensagens, leia os seguintes artigos na Base de dados de Conhecimento da Microsoft: Os exemplos a seguir usam o método Items.Add para criar um novo item baseado em um formulário de contato personalizado chamado MyForm: exemplos a seguir usam o método Items.Add para criar um novo item de contato padrão: Observação: se você usar o método Items.Add, não importa o que o formulário padrão para a pasta é. Você pode especificar qualquer classe de mensagem válida contanto que ele foi publicado na pasta ou tenha sido publicado na biblioteca de formulários particular ou organizacional.

Método CreateItemFromTemplate:

Use o método CreateItemFromTemplate para criar um novo item baseado em um arquivo de modelo do Outlook (.oft) ou formato de arquivo .msg. Porque a maioria dos formulários são publicados em uma pasta ou biblioteca de formulários, esse método não é usado normalmente. Provavelmente o motivo mais comum para usar esse método seria se você estivesse criando um programa de instalação do Microsoft Visual Basic para instalar formulários para uma solução do Outlook. Isso normalmente deve ser feito para usuários que não possuem acesso à rede ou normalmente trabalhar off-line no Outlook. O Visual Basic programa faria o seguinte:

• Automatize o Outlook.
• Use CreateItemFromTemplate para abrir um formulário de um compartilhamento de rede ou o disquete.
• Usando o modelo de objeto do Outlook, publique o formulário para uso posterior.

     ' Automation code example.
     Set ol = New Outlook.Application
     Set olns = ol.GetNameSpace("MAPI")
     ' Set MyFolder to the default contacts folder.
     Set MyFolder = olns.GetDefaultFolder(olFolderContacts)
     ' Set MyItem to an .oft file on a floppy disk.
     Set MyItem = ol.CreateItemFromTemplate("A:\Contact.oft")
     ' Set MyForm to the item Form Description for publishing.
     Set MyForm = MyItem.FormDescription
     ' Name the form, which also sets its message class.
     MyForm.Name = "My Contact"
     ' Publish the folder to the Contacts folder.
     MyForm.PublishForm olFolderRegistry, MyFolder
     ' Close and do not save changes to the item.
     MyItem.Close olDiscard
  						

Referenciar itens existentes

Usar itens (i) ou for each... Next:

Geralmente essas abordagens são usadas para percorrer todos os itens em uma pasta. A coleção de itens contém todos os itens em uma pasta específica e você pode especificar qual item fará referência usando um índice com a coleção Items. Normalmente, isso é usado com For I = 1 para construção de programação n.

Se você estiver usando o VBScript versão 2.0 ou posterior, você pode usar em vez disso, a construção de programação for each... Next para percorrer os itens na coleção sem especificar um índice. Ambas as abordagens obter o mesmo resultado.

Os exemplos a seguintes usam a abordagem itens (i) para efetuar loop por todos os contatos na pasta Contatos e exibir seu campo NomeCompleto em uma caixa de diálogo. os exemplos seguintes usam a construção for each... Next para atingir o mesmo resultado como exemplos anteriores: Items("This is the subject") usando:

Você também pode usar a coleção Items e especificar uma seqüência de caracteres de texto que corresponda ao campo assunto de um item. Essa abordagem não é usada normalmente.

Os exemplos a seguintes exibem um item da caixa de entrada cujo assunto contém "Please help on Friday!" localizar método:

Use o método Find para procurar um item em uma pasta com base no valor de um de seus campos. Se a localização é bem-sucedida, você pode usar o método FindNext para procurar itens adicionais que satisfazem o mesmo critério de pesquisa.

Pesquisar os exemplos a seguir para verificar se você tem compromissos alta prioridade. restringir método:

O método Restrict é semelhante para o método Find, mas em vez de retornar um único item, ele retorna uma coleção de itens que atendem os critérios de pesquisa. Por exemplo, você pode usar esse método para localizar todos os contatos que trabalham na mesma empresa.

Os exemplos seguintes exibem todos os contatos que trabalham na ACME software: método GetItemFromID:

Este método geralmente seria usado em soluções mais complexas onde uma solução mantém controle sobre a StoreID e EntryID de um item para que ele pode ser recuperado rapidamente em um momento posterior.

Para obter mais informações sobre como usar o método GetItemFromID, consulte o seguinte artigo na Base de dados de Conhecimento da Microsoft:

Para obter mais informações sobre como criar soluções com o Microsoft Outlook 97, consulte os seguintes artigos na Base de dados de Conhecimento da Microsoft: