Explorer. Méthode AddToSelection (Outlook)

Ajoute l’élément Microsoft Outlook spécifié à la sélection dans l’Explorateur actif.

Syntaxe

expression. AddToSelection (Item)

expression Variable qui représente un objet Explorer.

Paramètres

Nom Requis/Facultatif Type de données Description
Item Obligatoire Object Élément à ajouter à la sélection dans l’explorateur actif.

Remarques

La sélection dans l’explorateur actif est représentée par l’objet Selection renvoyé par l’Explorer. Propriété Selection (Sélection).

Pour être sélectionné, l’élément doit pouvoir être sélectionnable dans l’affichage en cours de l’explorateur actif. Utilisez la méthode IsItemSelectableInView pour déterminer si l’élément peut être sélectionné dans la vue. L’élément n’a pas à être visible dans l’affichage.

Dans les conditions suivantes, Outlook renvoie une erreur lorsque vous appelez la méthode AddToSelection :

  • L’élément spécifié ne figure pas dans l’affichage actuel de l’explorateur actif.
  • L’élément spécifié est en cours de modification dans l’affichage actuel de l’explorateur actif.
  • La vue actuelle a été filtrée et l’application du filtre a supprimé l’élément de la vue.
  • L’élément spécifié n’a pas été enregistré.
  • L’élément spécifié représente un élément de stockage.
  • Aucun affichage actuel n’existe pour l’explorateur actif.

Si l’élément n’est pas sélectionné et qu’il est sélectionnable dans l’affichage actuel, l’appel de AddToSelection entraîne le déclenchement de l’événement SelectionChange.

L’appel de AddToSelection ne fait pas défiler l’affichage pour y rendre visible l’élément sélectionné, ni ne réduit ou ne développe les groupes de l’affichage.

Le tableau suivant illustre les résultats de l’appel de AddToSelection, en prenant en considération toute sélection actuelle (propriété Selection.Count ) et si le volet de lecture est affiché.

Existing Selection.Count Volet de lecture affiché Résultats
0 Oui
  • L’élément est ajouté à la sélection.
  • SelectionChange se déclenche.
  • Le volet de lecture affiche l’élément.
0 Non
  • L’élément est ajouté à la sélection.
  • SelectionChange se déclenche.
>=1 Oui
  • L’élément est ajouté à la sélection.
  • SelectionChange se déclenche.
  • Le volet de lecture ne modifie pas l’élément qu’il affiche, sauf si l’affichage est un affichage Calendrier, auquel cas l’appel de AddToSelection peut entraîner l’affichage d’un élément différent dans le volet de lecture.
>=1 Non
  • L’élément est ajouté à la sélection.
  • SelectionChange se déclenche.

Si l’élément spécifié est déjà sélectionné dans l’explorateur actif, l’appel AddToSelection n’entraîne aucune modification de la sélection et l’événement SelectionChange ne se déclenche pas.

Lorsque vous spécifiez un élément d’un rendez-vous ou d’une tâche périodique en tant qu’argument de la méthode AddToSelection, assurez-vous d’obtenir une instance de l’occurrence avant de transmettre l’argument, en développant d’abord les périodicités à l’aide de la propriété IncludeRecurrences et de la collection Items. Si vous ne développez pas les périodicités et n’obtenez pas d’occurrence dans la série, vous passez une variable d’instance qui représente le rendez-vous ou la série de tâches, et la méthode AddToSelection opère sur la série au lieu de l’occurrence.

Notez que vous pouvez utiliser AddToSelection pour ajouter des éléments à une sélection, mais que vous ne pouvez pas ajouter d’en-têtes de conversation à une sélection.

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.

  • Last updated on