Partager via

Explorer.AddToSelection, méthode (Outlook)

  • Article

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 .

Parameters

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 retourné par la propriété Explorer.Selection .

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 retourne 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.
  • L’affichage actuel a été filtré 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 objet StorageItem.
  • 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 tenant compte de toute sélection actuelle (la propriété Selection.Count ) et si le volet de lecture est affiché.

Selection.Count existant 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 s’il s’agit d’un affichage Calendrier, auquel cas l’appel de AddToSelection peut entraîner l’affichage d’un autre élément 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 de 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 dans un rendez-vous ou une tâche périodique comme argument de la méthode AddToSelection , assurez-vous qu’avant de passer l’argument, vous obtenez une instance de l’occurrence 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 la série de rendez-vous ou de tâches, et la méthode AddToSelection fonctionne 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.