Поделиться через


_Explorer.AddToSelection(Object) Метод

Определение

Добавляет указанный элемент Microsoft Outlook в выделенный элемент в активном проводнике.

public:
 void AddToSelection(System::Object ^ Item);
public void AddToSelection (object Item);
Public Sub AddToSelection (Item As Object)

Параметры

Item
Object

Элемент, добавляемый к выделенному фрагменту в активном обозревателе.

Комментарии

Выделение в активном обзоре представлено Selection объектом, возвращаемым свойством Selection .

Для выбора элемента необходимо выбрать в текущем представлении активного обозревателя. Используйте метод , IsItemSelectableInView(Object) чтобы определить, можно ли выбрать элемент в представлении. Элемент не обязательно должен быть видимым в представлении.

В следующих условиях Outlook возвращает ошибку при вызове метода AddToSelection :

Если элемент не выбран и его можно выбрать в текущем представлении, вызов AddToSelection приведет к возникновению SelectionChange события.

Вызов Метода AddToSelection не прокручивает представление, чтобы сделать выбранный элемент видимым в представлении, и не разворачивает и не сворачивает группы в представлении.

В следующей таблице показаны результаты вызова AddToSelection с учетом любого текущего Count выделения (свойства) и отображения области чтения.

0ДаЭлемент добавляется к выделенному фрагменту. ВыделениеИзменение срабатывает. Элемент отображается в области чтения.
0НетЭлемент добавляется к выделенному фрагменту. ВыделениеИзменение срабатывает.
>=1ДаЭлемент добавляется к выделенному фрагменту. ВыделениеИзменение срабатывает. Область чтения не изменяет отображаемый элемент, если представление не является представлением календаря. В этом случае вызов AddToSelection может привести к отображению другого элемента в области чтения.
>=1НетЭлемент добавляется к выделенному фрагменту. ВыделениеИзменение срабатывает.

Если указанный элемент уже выбран в активном обозревателе, вызов AddToSelection не приведет к изменению выделения и событие SelectionChange не срабатывает.

При указании элемента в повторяющейся встрече или задаче в качестве аргумента метода AddToSelection убедитесь, что перед передачей аргумента вы получите экземпляр вхождения, сначала развернув повторения с помощью IncludeRecurrences свойства и Items коллекции. Если не развернуть повторения и не получить вхождения в ряде, передайте переменную экземпляра, представляющую встречу или ряд задач, а метод AddToSelection работает с рядом, а не с вхождением.

Обратите внимание, что вы можете использовать AddToSelection для добавления элементов в выделенный фрагмент, но вы не можете добавить заголовки беседы в выделенный фрагмент.

Применяется к