Freigeben über

Explorer. AddToSelection-Methode (Outlook)

  • Artikel

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

Syntax

Ausdruck. AddToSelection (Element)

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. Selection-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 die Anwendung des Filters hat 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.

In der folgenden Tabelle werden die Ergebnisse des Aufrufs von AddToSelection unter Berücksichtigung der aktuellen Auswahl ( selection.Count-Eigenschaft ) und der Anzeige des Lesebereichs veranschaulicht.

Vorhandene 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 Kalenderansicht. 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 das Aufrufen von AddToSelection zu keiner Änderung der Auswahl, und das SelectionChange-Ereignis wird nicht ausgelöst.

Wenn Sie ein Element in einer Termin- oder Aufgabenserie als Argument für die AddToSelection-Methode angeben, stellen Sie sicher, dass Sie vor dem Ü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 die Termin- oder Aufgabenreihe darstellt, und die AddToSelection-Methode arbeitet auf der Reihe anstelle des Vorkommens.

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.