_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)使用 方法确定是否可以在视图中选择该项。 该项目不必在视图中可见。

在以下情况下,当您调用 RemoveFromSelection 方法时,Outlook 将返回错误:

如果选择了该项,则调用 RemoveFromSelection 会导致 SelectionChange 触发事件。 如果未选中此项,调用 RemoveFromSelection 不会导致 SelectionChange 事件的开始。

调用 RemoveFromSelection 不会滚动视图以使所选项目在视图中可见,也不会在视图中展开或折叠组。

下表说明了调用 RemoveFromSelection 的结果,其中考虑了属性) (Count 当前选择、是否显示阅读窗格以及指定的项是否显示在阅读窗格中。

1已清除所选内容。SelectionChange 触发。阅读窗格为空。
>1项目将从选定内容中删除。SelectionChange 触发。阅读窗格不会更改。
>1项目将从选定内容中删除。SelectionChange 触发。阅读窗格显示所选内容中的下一项或相邻项。
>=1不适用项目将从选定内容中删除。SelectionChange 触发。

如果指定项存在于当前视图中,但在该视图中未选中,则调用 RemoveFromSelection 不会导致对所选内容进行任何更改,并且 SelectionChange 事件不会触发。

将定期约会或任务中的项指定为 RemoveFromSelection 方法的参数时,请确保在传递参数之前,首先使用 IncludeRecurrences 属性和 Items 集合展开重复周期来获取该实例。 如果不展开定期事件,并且获得系列中出现,您可以传递实例变量表示的约会或任务系列,和 RemoveFromSelection 方法将运行而不是出现一系列上。

适用于