Freigeben über


Explorer. RemoveFromSelection-Methode (Outlook)

Hebt die Auswahl des angegebenen Microsoft Outlook-Elements im aktiven Explorer auf.

Syntax

Ausdruck. RemoveFromSelection (Element)

Ausdruck Eine Variable, die ein Explorer -Objekt darstellt.

Parameter

Name Erforderlich/Optional Datentyp Beschreibung
Item Erforderlich Objekt Das aus der Auswahl zu entfernende Element.

Hinweise

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

Um aus einer Auswahl entfernt zu werden, muss ein Element in der aktuellen Ansicht des aktiven Explorers ausgewählt werden können. Das Element muss jedoch nicht in der Ansicht sichtbar sein.

Outlook gibt unter folgenden Umständen beim Aufruf der RemoveFromSelection-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.
  • Die aktuelle Ansicht ist eine Unterhaltungsansicht.
  • Für den aktiven Explorer ist keine aktuelle Ansicht vorhanden.

Wenn das angegebene Element ausgewählt ist, bewirkt ein Aufruf von RemoveFromSelection die Auslösung des SelectionChange-Ereignisses. Wenn das Element nicht ausgewählt ist, bewirkt ein Aufruf von RemoveFromSelection kein Auslösen des SelectionChange-Ereignisses.

Das Aufrufen von RemoveFromSelection verschiebt nicht den Fensterinhalt, um das angegebene Element sichtbar zu machen und erweitert oder reduziert keine Gruppen in der Ansicht.

In der folgenden Tabelle werden die Ergebnisse des Aufrufs von RemoveFromSelection unter Berücksichtigung einer beliebigen aktuellen Auswahl ( selection.Count-Eigenschaft ) veranschaulicht, ob der Lesebereich angezeigt wird und ob das angegebene Element im Lesebereich angezeigt wird.

Vorhandene Selection.Count Angezeigter Lesebereich Angegebenes Element, das im Lesebereich angezeigt wird Ergebnisse
1 Ja Ja
  • Die Auswahl wird aufgehoben.
  • SelectionChange wird ausgelöst.
  • Lesebereich ist leer.
>1 Ja Nein
  • Das Element wird aus der Auswahl entfernt.
  • SelectionChange wird ausgelöst.
  • Der Lesebereich ändert sich nicht.
>1 Ja Ja
  • Das Element wird aus der Auswahl entfernt.
  • SelectionChange wird ausgelöst.
  • Im Lesebereich wird das nächste Element oder angrenzende Element in der Auswahl angezeigt.
>=1 Nein Nicht zutreffend
  • Das Element wird aus der Auswahl entfernt.
  • SelectionChange wird ausgelöst.

Wenn das angegebene Element in der aktuellen Ansicht vorhanden aber in der Ansicht nicht ausgewählt ist, bewirkt ein Aufruf von RemoveFromSelection keine Änderung an der Auswahl und löst das SelectionChange-Ereignis nicht aus.

Wenn Sie ein Element in einer Termin- oder Aufgabenserie als Argument für die RemoveFromSelection-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 RemoveFromSelection-Methode würde für die Reihe anstelle des Vorkommens verwendet.

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.