_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 будет работать с рядом, а не с вхождением.