Explorer. Méthode RemoveFromSelection (Outlook)

Annule la sélection de l’élément Microsoft Outlook spécifié dans l’explorateur actif.

Syntaxe

expression. RemoveFromSelection (Item)

expression Variable qui représente un objet Explorer.

Paramètres

Nom	Requis/Facultatif	Type de données	Description
Item	Obligatoire	Object	Élément à supprimer de la sélection.

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 supprimé d’une sélection, l’élément doit pouvoir être sélectionnable dans l’affichage actuel de l’explorateur actif. Cependant, l’élément n’a pas à être visible dans l’affichage.

Outlook renvoie une erreur quand vous appelez la méthode RemoveFromSelection dans les situations suivantes :

• 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.
• L’affichage en cours est un affichage Conversation.
• Aucun affichage actuel n’existe pour l’explorateur actif.

Si l’élément spécifié est sélectionné, l’appel de RemoveFromSelection entraîne le déclenchement de l’événement SelectionChange. Si l’élément n’est pas sélectionné, l’appel de RemoveFromSelection ne provoque pas le déclenchement de l’événement SelectionChange.

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

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

Existing Selection.Count	Volet de lecture affiché	L’élément spécifié s’affiche dans le volet de lecture	Résultats
1	Oui	Oui	La sélection est effacée. SelectionChange se déclenche. Le volet de lecture est vide.
>1	Oui	Non	L’élément est supprimé de la sélection. SelectionChange se déclenche. Le volet de lecture ne change pas.
>1	Oui	Oui	L’élément est supprimé de la sélection. SelectionChange se déclenche. Le volet de lecture affiche l’élément suivant ou l’élément adjacent dans la sélection.
>=1	Non	S/O	L’élément est supprimé de la sélection. SelectionChange se déclenche.

Si l’élément spécifié existe dans l’affichage actuel mais n’y est pas sélectionné, l’appel de RemoveFromSelection n’entraîne aucune modification dans 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 RemoveFromSelection, assurez-vous d’obtenir une instance de l’occurrence avant de passer 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 transmettez une variable d’instance qui représente la série de tâches ou de rendez-vous, et la méthode RemoveFromSelection fonctionne sur la série au lieu de l’occurrence.

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.