Метод Explorer.AddToSelection (Outlook)

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

Синтаксис

expression. AddToSelection (Item)

Выражение Переменная, представляющая объект Explorer .

Параметры

Имя	Обязательный или необязательный	Тип данных	Описание
Элемент	Обязательный	Object	Элемент, добавляемый к выделенному фрагменту в активном обозревателе.

Замечания

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

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

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

• Указанный элемент отсутствует в текущем представлении активного обозревателя.
• Указанный элемент редактируется в текущем представлении активного обозревателя.
• Текущее представление было отфильтровено, и приложение фильтра удалило элемент из представления.
• Указанный элемент не сохранен.
• Указанный элемент представляет объект StorageItem.
• Текущее представление для активного обозревателя не существует.

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

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

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

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

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

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

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

Поддержка и обратная связь

Есть вопросы или отзывы, касающиеся Office VBA или этой статьи? Руководство по другим способам получения поддержки и отправки отзывов см. в статье Поддержка Office VBA и обратная связь.