_Explorer.AddToSelection(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.
Das angegebene Microsoft Outlook-Element hinzugefügt der Markierung im aktiven Explorer.
public:
void AddToSelection(System::Object ^ Item);public void AddToSelection (object Item);Public Sub AddToSelection (Item As Object)Parameter
- Item
- Object
Das Element, das der Auswahl im aktiven Explorer hinzugefügt werden soll.
Hinweise
Die Auswahl im aktiven Explore wird durch das Selection Objekt dargestellt, das von der Selection -Eigenschaft zurückgegeben wird.
Damit es ausgewählt wird, muss das Element in der aktuellen Ansicht des aktuellen Explorers auswählbar sein. 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 Umständen gibt Outlook beim Aufruf der AddToSelection -Methode einen Fehler zurück:
Wenn das Element nicht ausgewählt ist und in der aktuellen Ansicht ausgewählt werden kann, wird das Ereignis durch Aufrufen von SelectionChangeAddToSelection ausgelöst.
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 (die Count -Eigenschaft) und der Anzeige des Lesebereichs veranschaulicht.
| 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 nur, wenn es sich bei der Ansicht um eine Kalenderansicht handelt. 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, Aufruf von AddToSelection nicht zu einer Ä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 nicht die Wiederholungen erweitern und das auftreten ein Serientermins in der Datenreihe zu erhalten, übergeben Sie eine Instanzvariable, die die Datenreihe Termins oder einer Aufgabe darstellt, und die AddToSelection -Methode der Datenreihe nicht das kontinuierlich ausgeführt wird.
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.