Anzeigen von Namen aus dem Adressbuch

This topic describes the address book and explains how to programmatically display names from an address book in the Outlook Address Book dialog box.

In Outlook wird eine Hierarchie von Adressbüchern für eine Sitzung verwaltet. Damit durch den Transportanbieter eine Nachricht übermittelt werden kann, muss für den Empfänger ein Adresseintrag in einem der Adressbücher in dieser Hierarchie vorhanden sein.

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. Standardmäßig enthält sie eine Adressliste für die Kontakte im Ordner Kontakte, die mindestens eine E-Mail-Adresse oder Faxnummer eingeben. As you create other folders in the Contacts module, by default, each folder will also become an address list in the Outlook Address Book. Auf der Registerkarte Outlook-Adressbuch des Dialogfelds Eigenschaften für den Ordner können Sie diesen Ordner als E-Mail-Adressbuch anzeigen auswählen oder deaktivieren.

Aus Sicht der Programmierbarkeit verwaltet Outlook eine Sammlung von AddressLists für die aktuelle Sitzung. Each AddressList consists of a collection of AddressEntries. Es gibt verschiedene Typen von Adresslisten (wie von OlAddressListType aufgezählt) und verschiedene Typen von Adresseinträgen (wie von OlAddressEntryUserType aufgezählt). When you add a folder to the Contacts module, you can use Folder.ShowAsOutlookAB to specify whether that folder will be displayed as an address list in the Outlook Address Book.

Das Recipient-Objekt ist einem AddressEntry-Objekt zugeordnet, das von der Recipient.Address-Eigenschaft angegeben wird. Sie können auch die AddressEntry.AddressEntryUserType-Eigenschaft verwenden, um den Typ des Empfängers zu identifizieren, z. B. ob der Empfänger ein Kontaktelement, ein Exchange-Benutzer oder eine Exchange-Verteilerliste ist.

Mit dem SelectNamesDialog-Objekt können Sie Namen aus einer Adressliste in einem Dialogfeld anzeigen, das dem Dialogfeld Namen auswählen in der Outlook-Benutzeroberfläche ähnelt. The following figure is an example of the Select Names dialog box displaying the Contacts folder.

Das Dialogfeld ermöglicht es einem Benutzer, Einträge aus einer oder mehreren Adresslisten im Adressbuch auszuwählen, und gibt die ausgewählten Empfänger in der SelectNamesDialog.Recipients-Eigenschaft zurück. Mithilfe der Eigenschaften und Methoden von SelectNamesDialog können Sie die folgenden Aspekte des Dialogfelds steuern:

• Die anfängliche Adressliste, die im Dialogfeld angezeigt werden soll, und ob nur diese Adressliste angezeigt werden soll.

• Die Anzahl der Empfängerauswahlelemente, z. B. ob alle drei Beschriftungen An, Cc und Bcc angezeigt werden sollen.

• Die Zeichenfolgen, die ggf. die Bezeichnungen title, To, Cc und Bcc darstellen. Lange Titel und Beschriftungen werden abgeschnitten, ohne dass die Breite des Dialogfelds geändert wird.

• Ob der Benutzer jeweils einen oder mehrere Adresseinträge auswählen kann.

• Ob Empfängernamen vor dem Schließen des Dialogfelds aufgelöst werden sollen.

• Was geschehen soll, wenn nicht alle Empfänger aufgelöst werden.

So zeigen Sie das Dialogfeld mit Namen aus einer Adressliste an:

1. Verwenden Sie die GetSelectNamesDialog-Methode der aktuellen Sitzung (angegeben durch Application.Session), um eine Instanz des SelectNamesDialog-Objekts für die aktuelle Sitzung abzurufen.

2. Verwenden Sie die AddressLists-Eigenschaft der aktuellen Sitzung, um die Sammlung von AddressLists für die aktuelle Sitzung abzurufen.

3. Standardmäßig wird das Dialogfeld mit der Adressliste initialisiert, für die AddressList.IsInitialAddressList auf True festgelegt ist. Bei Bedarf können Sie SelectNamesDialog.InitialAddressList verwenden, um das Dialogfeld mit einer anderen AddressList aus der AddressLists-Auflistung in Schritt 2 zu initialisieren.

4. Use SelectNamesDialog.Display to display the dialog box. Durch diese Methode wird abhängig von SelectNamesDialog.ForceResolution und der Antwort des Benutzers True oder False zurückgegeben:

   • Diese Methode gibt True zurück, wenn SelectNamesDialog.ForceResolution festgelegt ist, alle ausgewählten Namen aufgelöst werden und der Benutzer auf OK klickt.

• Es wird False zurückgegeben, wenn SelectNamesDialog.ForceResolution festgelegt ist, aber nicht alle Empfänger aufgelöst werden.

• False wird zurückgegeben , wenn SelectNamesDialog.ForceResolution nicht festgelegt ist und der Benutzer auf OK klickt.

• False wird zurückgegeben , wenn der Benutzer auf Abbrechen oder auf das Symbol Schließen klickt.

5. Wenn SelectNamesDialog.DisplayTrue zurückgibt, rufen Sie die ausgewählten Adresseinträge mithilfe von SelectNamesDialog.Recipients ab.

Siehe auch

Vorgehensweise: Identifizieren der globalen Adressliste oder eines Adresslistensatzes für den aktuellen Informationsspeicher

Support und Feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.