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


_Explorer.RemoveFromSelection(Object) Метод

Определение

Отменяет выбор указанного элемента Microsoft Outlook в активном обозревателе.

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

Параметры

Item
Object

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

Комментарии

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

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

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

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

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

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

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

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

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

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