_Explorer.AddToSelection(Object) Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Ajoute l’élément Microsoft Outlook spécifié à la sélection dans l’explorateur actif.
public:
void AddToSelection(System::Object ^ Item);public void AddToSelection (object Item);Public Sub AddToSelection (Item As Object)Paramètres
- Item
- Object
Élément à ajouter à la sélection dans l’explorateur actif.
Remarques
La sélection dans l’exploration active est représentée par l’objet Selection retourné par la Selection propriété .
Pour être sélectionné, l’élément doit pouvoir être sélectionnable dans l’affichage en cours 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 AddToSelection :
Si l’élément n’est pas sélectionné et qu’il est sélectionnable dans l’affichage actuel, l’appel de AddToSelection provoque 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 Count propriété) et si le volet de lecture est affiché.
| 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 dans 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 un 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 périodicités et n’obtenez pas d’occurrence dans la série, vous passez une variable 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.