_Explorer.RemoveFromSelection(Object) 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
取消选中活动资源管理器中指定的 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 方法将运行而不是出现一系列上。