_Explorer.RemoveFromSelection(Object) Méthode

Définition

Espace de noms:

Microsoft.Office.Interop.Outlook

Assembly:

Microsoft.Office.Interop.Outlook.dll

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

public:
 void RemoveFromSelection(System::Object ^ Item);

public void RemoveFromSelection (object Item);

Public Sub RemoveFromSelection (Item As Object)

Paramètres

Item

Object

Élément à supprimer de la sélection.

Remarques

La sélection dans l’exploration active est représentée par l’objet Selection retourné par la Selection propriété .

Pour être supprimé, un élément doit être sélectionnable dans l’affichage actuel de l’explorateur actif. Utilisez la IsItemSelectableInView(Object) méthode 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 RemoveFromSelection :

Si l’élément est sélectionné, l’appel de RemoveFromSelection provoque 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 rendre l’élément sélectionné visible dans l’affichage et ne développe ni ne réduit les groupes dans l’affichage.

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

	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 ou l’élément adjacent suivant 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’est pas sélectionné dans cette vue, l’appel de RemoveFromSelection 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 RemoveFromSelection, 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 IncludeRecurrences propriété et de la Items collection. Si vous ne développez pas les occurrences et en obtenez une dans la série, vous passez une variable d’instance qui représente la série de rendez-vous ou de tâches ; la méthode RemoveFromSelection agit alors sur la série, et non sur l’occurrence.