_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 для добавления элементов в выделенный фрагмент, но вы не можете добавить заголовки беседы в выделенный фрагмент.