Explorer. AddToSelection-Methode (Outlook)

Das angegebene Microsoft Outlook-Element hinzugefügt der Markierung im aktiven Explorer.

Syntax

Ausdruck verwendet werden. AddToSelection (Item)

Ausdruck Eine Variable, die ein Explorer-Objekt darstellt.

Parameter

Name	Erforderlich/Optional	Datentyp	Beschreibung
Item	Erforderlich	Object	Das Element, das der Auswahl im aktiven Explorer hinzugefügt werden soll.

Hinweise

Die Auswahl im aktiven Explorer wird durch das Selection-Objekt dargestellt, das vom Explorer zurückgegeben wird. Auswahl-Eigenschaft.

Damit es ausgewählt wird, muss das Element in der aktuellen Ansicht des aktuellen Explorers auswählbar sein. Verwenden Sie die IsItemSelectableInView -Methode, um zu bestimmen, ob das Element in der Ansicht ausgewählt werden kann. Das Element muss in der Ansicht nicht sichtbar sein.

Unter den folgenden Umständen gibt Outlook beim Aufruf der AddToSelection -Methode einen Fehler zurück:

• Das angegebene Element befindet sich nicht in der aktuellen Ansicht des aktiven Explorers.
• Das angegebene Element wird in der aktuellen Ansicht des aktiven Explorers bearbeitet.
• Die aktuelle Ansicht wurde gefiltert, und durch die Anwendung des Filters wurde das Element aus der Ansicht entfernt.
• Das angegebene Element wurde nicht gespeichert.
• Das angegebene Element stellt ein StorageItem dar.
• Für den aktiven Explorer ist keine aktuelle Ansicht vorhanden.

Wenn das Element nicht ausgewählt ist und in der aktuellen Ansicht ausgewählt ist, bewirkt der Aufruf von AddToSelection das SelectionChange -Ereignis ausgelöst werden.

Aufruf von AddToSelection nicht den Fensterinhalt der Ansicht, um das ausgewählte Element in der Ansicht sichtbar zu machen und erweitert oder reduziert keine Gruppen in der Ansicht.

Die folgende Tabelle zeigt die Ergebnisse des Aufrufs von AddToSelection unter Berücksichtigung einer etwaigen aktuellen Auswahl (der Selection.Count-Eigenschaft ) und der Angabe der Lesebereichs.

Existing Selection.Count	Angezeigter Lesebereich	Ergebnisse
0	Ja	Das Element wird der Auswahl hinzugefügt. SelectionChange wird ausgelöst. Im Lesebereich wird das Element angezeigt.
0	Nein	Das Element wird der Auswahl hinzugefügt. SelectionChange wird ausgelöst.
>=1	Ja	Das Element wird der Auswahl hinzugefügt. SelectionChange wird ausgelöst. Der Lesebereich ändert das angezeigte Element nicht, es sei denn, die Ansicht ist eine Calendar-Ansicht. In diesem Fall kann der Aufruf von AddToSelection dazu führen, dass im Lesebereich ein anderes Element angezeigt wird.
>=1	Nein	Das Element wird der Auswahl hinzugefügt. SelectionChange wird ausgelöst.

Wenn das angegebene Element bereits im aktiven Explorer ausgewählt ist, führt der Aufruf von AddToSelection nicht zu einer Änderung der Auswahl, und das SelectionChange-Ereignis wird nicht ausgelöst.

Wenn Sie ein Element in einem wiederkehrenden Termin oder einer wiederkehrenden Aufgabe als Argument für die AddToSelection-Methode angeben, stellen Sie sicher, dass Sie vor Übergeben des Arguments eine instance des Vorkommens erhalten, indem Sie zuerst die Wiederholungen mithilfe der IncludeRecurrences-Eigenschaft und der Items-Auflistung erweitern. Wenn Sie die Wiederholungen nicht erweitern und ein Vorkommen in der Reihe erhalten, übergeben Sie eine instance-Variable, die den Termin oder die Aufgabenserie darstellt, und die AddToSelection-Methode wird auf die Reihe anstelle des Vorkommens angewendet.

Beachten Sie, dass Sie AddToSelection zum Hinzufügen von Elementen zu einer Auswahl verwenden können, aber Sie können nicht hinzufügen von unterhaltungskopfzeilen zu einer Auswahl.

Support und Feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.