_Explorer.RemoveFromSelection(Object) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Hebt die Auswahl des angegebenen Microsoft Outlook-Elements im aktiven Explorer auf.
public:
void RemoveFromSelection(System::Object ^ Item);public void RemoveFromSelection (object Item);Public Sub RemoveFromSelection (Item As Object)Parameter
- Item
- Object
Das aus der Auswahl zu entfernende Element.
Hinweise
Die Auswahl im aktiven Explore wird durch das Selection Objekt dargestellt, das von der Selection -Eigenschaft zurückgegeben wird.
Um entfernt zu werden, muss ein Element in der aktuellen Ansicht des aktiven Explorers ausgewählt werden können. Verwenden Sie die IsItemSelectableInView(Object) -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 Bedingungen gibt Outlook einen Fehler zurück, wenn Sie die RemoveFromSelection-Methode aufrufen:
Wenn das Element ausgewählt ist, wird das SelectionChange Ereignis durch Aufrufen von RemoveFromSelection ausgelöst. Wenn das Element nicht ausgewählt ist, bewirkt ein Aufruf von RemoveFromSelection kein Auslösen des SelectionChange-Ereignisses.
Beim Aufrufen von RemoveFromSelection wird kein Bildlauf in der Ansicht vorgenommen, um das ausgewählte Element in der Ansicht sichtbar zu machen, und gruppen in der Ansicht werden nicht erweitert oder reduziert.
In der folgenden Tabelle werden die Ergebnisse des Aufrufs von RemoveFromSelection unter Berücksichtigung einer beliebigen aktuellen Auswahl (der Count -Eigenschaft) veranschaulicht, ob der Lesebereich angezeigt wird und ob das angegebene Element im Lesebereich angezeigt wird.
| 1 | Ja | Ja | Die Auswahl ist deaktiviert. 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 ist, aber in dieser Ansicht nicht ausgewählt ist, führt der Aufruf von RemoveFromSelection 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 RemoveFromSelection-Methode angeben, stellen Sie sicher, dass Sie vor dem Übergeben des Arguments eine instance des Vorkommens erhalten, indem Sie zuerst die Serien 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.