Display Names from the Address Book

Este tópico descreve o catálogo de endereços e explica como exibir nomes programaticamente de um catálogo de endereços na caixa de diálogo Catálogo de Endereços do Outlook.

O Outlook mantém uma hierarquia de catálogos de endereços em uma sessão. In order for the transport provider to deliver a message, the recipient must have an address entry in one of the address books in this hierarchy.

An address book contains one or more address lists. Each address list is composed of users, distribution lists, or other types of address entries. An example of an address list is the Exchange Global Address List. In the Outlook user interface, you can open the Address Book dialog box to view and select names in an address list. When you create a mail item or appointment item, or when you assign a task item, you can use the Address Book to help you select recipients.

The Outlook Address Book is an address list or a set of address lists that Outlook creates automatically. Por padrão, ele contém uma lista de endereços para os contatos na pasta Contatos que têm pelo menos um endereço de email ou entrada de número de fax. As you create other folders in the Contacts module, by default, each folder will also become an address list in the Outlook Address Book. Na guia Catálogo de Endereços do Outlook da caixa de diálogo Propriedades da pasta, você pode selecionar ou desmarque Mostrar essa pasta como um catálogo de endereços de email.

Na perspectiva de programação, o Outlook mantém uma coleção de AddressLists para a sessão atual. Each AddressList consists of a collection of AddressEntries. Há diferentes tipos de listas de endereços (como enumerado por OlAddressListType) e diferentes tipos de entradas de endereço (conforme enumerado por OlAddressEntryUserType). Ao adicionar uma pasta ao módulo Contatos, você pode usar Folder.ShowAsOutlookAB para especificar se essa pasta será exibida como uma lista de endereços no Outlook Address Book.

O objeto Destinatário está associado a um objeto AddressEntry especificado pela propriedade Recipient.Address . Você também pode usar a propriedade AddressEntry.AddressEntryUserType para identificar o tipo do destinatário, por exemplo, se o destinatário é um item Contact, um usuário do Exchange ou uma lista de distribuição do Exchange.

O objeto SelectNamesDialog permite exibir nomes de uma lista de endereços em uma caixa de diálogo que se assemelha à caixa de diálogo Selecionar Nomes na interface do usuário do Outlook. The following figure is an example of the Select Names dialog box displaying the Contacts folder.

A caixa de diálogo permite que um usuário selecione entradas de uma ou mais listas de endereços no Catálogo de Endereços e retorna os destinatários selecionados na propriedade SelectNamesDialog.Recipients . Through properties and methods of SelectNamesDialog, you can control the following aspects of the dialog box:

• The initial address list to be displayed in the dialog box, and whether to show only this address list.

• The number of recipient selectors, for example, whether to show all three labels of To, Cc, and Bcc.

• The strings representing the title, To, Cc, and Bcc labels where applicable. Long titles and labels will be truncated without resizing the width of the dialog box.

• Whether the user can select one or more address entries at a time.

• Whether to resolve recipient names before closing the dialog box.

• What to do if not all recipients are resolved.

To display the dialog box with names from an address list:

1. Use o método GetSelectNamesDialog da sessão atual (indicado por Application.Session) para obter uma instância do objeto SelectNamesDialog para a sessão atual.

2. Use the AddressLists property of the current session to obtain the collection of AddressLists for the current session.

3. Por padrão, a caixa de diálogo é inicializada com a lista de endereços que tem AddressList.IsInitialAddressList definido como True. If necessary, you can use SelectNamesDialog.InitialAddressList to initialize the dialog box with another AddressList from the AddressLists collection in Step 2.

4. Use SelectNamesDialog.Display to display the dialog box. Esse método retorna um True ou False dependendo de SelectNamesDialog.ForceResolution e da resposta do usuário:

   • Esse método retornará True se SelectNamesDialog.ForceResolution estiver definido, todos os nomes selecionados forem resolvidos e o usuário clicar em OK.

• Ele retornará False se SelectNamesDialog.ForceResolution estiver definido, mas nem todos os destinatários forem resolvidos.

• Ele retornará False se SelectNamesDialog.ForceResolution não estiver definido e o usuário clicar em OK.

• Ele retornará False se o usuário clicar em Cancelar ou no ícone Fechar .

5. Se SelectNamesDialog.Display retornar True, obtenha as entradas de endereço selecionadas usando SelectNamesDialog.Recipients.

Confira também

Como: identificar a Lista de Endereços Global ou um conjunto de listas de endereços com um repositório

Suporte e comentários

Tem dúvidas ou quer enviar comentários sobre o VBA para Office ou sobre esta documentação? Confira Suporte e comentários sobre o VBA para Office a fim de obter orientação sobre as maneiras pelas quais você pode receber suporte e fornecer comentários.