通过

Explorer.RemoveFromSelection 方法 (Outlook)

  • 项目

取消选中活动资源管理器中指定的 Microsoft Outlook项目。

语法

表达式。RemoveFromSelection (Item)

表达 一个代表 Explorer 对象的变量。

参数

名称 必需/可选 数据类型 说明
Item 必需 对象 要从选定内容中移除的项目。

备注

活动资源管理器中的选定内容由 Explorer.Selection 属性返回的 Selection 对象表示。

若要从选定内容中移除项目，该项目在活动资源管理器的当前视图中必须是可选择的。 但是，该项目不必在视图中可见。

当您调用 RemoveFromSelection 方法在下列情况下的，outlook 将返回一个错误:

  • 指定的项目不在活动资源管理器的当前视图中。
  • 指定的项目在活动资源管理器的当前视图中处于编辑状态。
  • 当前视图已经过筛选，并且筛选器的应用程序从视图中删除了该项。
  • 指定的项目未保存。
  • 指定的项目表示 StorageItem 。
  • 当前视图是对话视图。
  • 活动资源管理器没有当前视图存在。

如果选择了指定的项，则调用 RemoveFromSelection 将导致 SelectionChange 事件引发。 如果未选中此项，调用 RemoveFromSelection 不会导致 SelectionChange 事件的开始。

调用 RemoveFromSelection 并不滚动视图，以使指定的项在视图中可见，并不展开或折叠视图中的组。

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

现有 Selection.Count 显示的阅读窗格 “阅读”窗格中显示的指定项 结果
1 是 是
  • 选定内容被清除。
  • SelectionChange 激发。
  • 阅读窗格为空。
>1 是 否
  • 项目从选定内容中移除。
  • SelectionChange 激发。
  • 阅读窗格不会更改。
>1 是 是
  • 项目从选定内容中移除。
  • SelectionChange 激发。
  • 阅读窗格显示所选内容中的下一项或相邻项。
>=1 否 不适用
  • 项目从选定内容中移除。
  • SelectionChange 激发。

如果指定的项存在于当前的视图中，但未选择该视图中，调用 RemoveFromSelection 不会导致任何更改为所选内容，并不会触发 SelectionChange 事件。

将定期约会或任务中的项目指定为 RemoveFromSelection 方法的参数时，请确保在传递参数之前，首先通过使用 IncludeRecurrences 属性和 Items 集合展开重复周期来获取实例。 如果不展开重复周期并获取序列中的匹配项，则会传递一个表示约会或任务系列的实例变量， RemoveFromSelection 方法将对该系列而不是匹配项进行操作。

支持和反馈

有关于 Office VBA 或本文档的疑问或反馈？ 请参阅 Office VBA 支持和反馈，获取有关如何接收支持和提供反馈的指南。