Partager via


Afficher les noms du Carnet d'adresses

Cette rubrique décrit le carnet d'adresses et explique comment afficher par programme les noms d'un carnet d'adresses dans la boîte de dialogue Carnet d'adresses Outlook.

Outlook gère une hiérarchie de carnets d'adresses pour une même session. Afin de permettre au fournisseur de transport de remettre un message, le destinataire doit avoir une entrée d'adresse dans l'un des carnets d'adresses de cette hiérarchie.

Un carnet d'adresses contient une ou plusieurs listes d'adresses. Chaque liste d'adresses est composée d'utilisateurs, de listes de distribution ou d'autres types d'entrées d'adresse. La liste d'adresses globale d'Exchange est un exemple de liste d'adresses. Dans l'interface utilisateur d'Outlook, vous pouvez ouvrir la boîte de dialogue Carnet d'adresses pour afficher et sélectionner des noms dans une liste d'adresses. Lorsque vous créez un élément de courrier ou de rendez-vous ou que vous affectez un élément de tâche, le Carnet d'adresses vous permet de sélectionner les destinataires.

Le Carnet d'adresses Outlook est une liste d'adresses ou un jeu de listes d'adresses créées automatiquement par Outlook. Par défaut, il contient une liste d’adresses pour les contacts de votre dossier Contacts qui ont au moins une adresse e-mail ou une entrée de numéro de télécopie. À mesure que vous créez d'autres dossiers dans le module Contacts, par défaut, chaque dossier devient également une liste d'adresses dans le Carnet d'adresses Outlook. Sous l’onglet Carnet d’adresses Outlook de la boîte de dialogue Propriétés du dossier, vous pouvez sélectionner ou désélecter Afficher ce dossier sous forme de carnet d’adresses de messagerie.

Du point de vue de la programmabilité, Outlook gère une collection de AddressLists pour la session active. Chaque objet AddressList se compose d'une collection d'objets AddressEntries. Il existe différents types de listes d’adresses (comme énuméré par OlAddressListType) et différents types d’entrées d’adresse (comme énuméré par OlAddressEntryUserType). Lorsque vous ajoutez un dossier au module Contacts, vous pouvez utiliser la propriété Folder.ShowAsOutlookAB pour indiquer si ce dossier doit s'afficher en tant que liste d'adresses dans le Carnet d'adresses Outlook.

L’objet Recipient est associé à un objet AddressEntry spécifié par la propriété Recipient.Address. Vous pouvez également utiliser la propriété AddressEntry.AddressEntryUserType pour identifier le type du destinataire, par exemple s'il s'agit d'un élément Contact, d'un utilisateur Exchange ou d'une liste de distribution Exchange.

L’objet SelectNamesDialog vous permet d’afficher les noms d’une liste d’adresses dans une boîte de dialogue qui ressemble à la boîte de dialogue Sélectionner des noms dans l’interface utilisateur Outlook. La figure suivante est une illustration de la boîte de dialogue Sélectionner des noms avec le dossier Contacts affiché.

La boîte de dialogue permet à un utilisateur de sélectionner des entrées à partir d’une ou plusieurs listes d’adresses dans le carnet d’adresses et retourne les destinataires sélectionnés dans la propriété SelectNamesDialog.Recipients . Les propriétés et les méthodes de SelectNamesDialog vous permettent de contrôler les éléments suivants de la boîte de dialogue :

  • liste d'adresses initiale à afficher dans la boîte de dialogue, et si cette liste d'adresses doit être la seule à s'afficher ;

  • nombre de sélecteurs de destinataires, c'est-à-dire, si les trois intitulés À, Cc et Cci doivent être affichés ;

  • Chaînes représentant les étiquettes title, To, Cc et Cci , le cas échéant. Les titres et les intitulés longs sont tronqués sans que la boîte de dialogue soit redimensionnée dans la largeur ;

  • si l'utilisateur peut sélectionner une ou plusieurs entrées d'adresse à la fois ;

  • si les noms de destinataires doivent être résolus avant la fermeture de la boîte de dialogue ;

  • tâches à exécuter si les noms de destinataires ne sont pas tous résolus.

Pour afficher la boîte de dialogue avec les noms d'une liste d'adresses :

  1. Utilisez la méthode GetSelectNamesDialog de la session active (indiquée par Application.Session) pour obtenir une instance de l’objet SelectNamesDialog pour la session active.

  2. Utilisez la propriété AddressLists de la session active pour obtenir la collection d’AddressLists pour la session active.

  3. Par défaut, la boîte de dialogue est initialisée avec la liste d’adresses dont AddressList.IsInitialAddressList a la valeur True. Si nécessaire, vous pouvez utiliser SelectNamesDialog.InitialAddressList pour initialiser la boîte de dialogue avec un autre AddressList de la collection AddressLists à l’étape 2.

  4. Utilisez SelectNamesDialog.Display pour afficher la boîte de dialogue. Cette méthode renvoie une valeur True ou False en fonction de SelectNamesDialog.ForceResolution et de la réponse de l'utilisateur :

    • Cette méthode renvoie la valeur True si SelectNamesDialog.ForceResolution est défini, que tous les noms sélectionnés sont résolus et que l’utilisateur clique sur OK.
  • Elle retourne False si SelectNamesDialog.ForceResolution est défini, mais que tous les destinataires ne sont pas résolus.

  • Elle renvoie False si SelectNamesDialog.ForceResolution n’est pas défini et que l’utilisateur clique sur OK.

  • Elle retourne False si l’utilisateur clique sur Annuler ou sur l’icône Fermer .

  1. Si SelectNamesDialog.Display renvoie True, obtenez les entrées d’adresse sélectionnées à l’aide de SelectNamesDialog.Recipients.

Voir aussi

Procédure : identifier la liste d'adresses globales ou un ensemble de listes d'adresses avec un magasin

Assistance et commentaires

Avez-vous des questions ou des commentaires sur Office VBA ou sur cette documentation ? Consultez la rubrique concernant l’assistance pour Office VBA et l’envoi de commentaires afin d’obtenir des instructions pour recevoir une assistance et envoyer vos commentaires.