Explorer.AddToSelection 方法 (Outlook)
将指定的Microsoft Outlook项添加到活动资源管理器中的选定内容。
语法
表达式。AddToSelection (Item)
表达 一个代表 Explorer 对象的变量。
参数
| 名称 | 必需/可选 | 数据类型 | 说明 |
|---|---|---|---|
| Item | 必需 | 对象 | 添加到活动资源管理器中选定内容的项目。 |
备注
活动资源管理器中的选定内容由 Explorer.Selection 属性返回的 Selection 对象表示。
若要选择项目，该项目在活动资源管理器的当前视图中必须是可选择的。 使用 IsItemSelectableInView 方法可确定在视图中是否可以选择该项目。 该项目不必在视图中可见。
在以下情况下 Outlook 调用 AddToSelection 方法时返回一个错误:
- 指定的项目不在活动资源管理器的当前视图中。
- 指定的项目在活动资源管理器的当前视图中处于编辑状态。
- 当前视图已经过筛选，并且筛选器的应用程序从视图中删除了该项。
- 指定的项目未保存。
- 指定的项目表示 StorageItem 。
- 活动资源管理器没有当前视图存在。
如果该项目未被选中，是可选择与当前视图中的 AddToSelection 调用时， SelectionChange 事件的开始。
调用 AddToSelection 并不滚动视图以使选定的项在视图中可见，并不展开或折叠视图中的组。
下表说明了调用 AddToSelection 的结果，其中考虑了当前选择 (Selection.Count 属性) ，以及是否显示“阅读”窗格。
| 现有 Selection.Count | 显示的阅读窗格 | 结果 |
|---|---|---|
| 0 | 是 |
|
| 0 | 否 |
|
| >=1 | 是 |
|
| >=1 | 否 |
|
如果在活动资源管理器中已选择指定项，则调用 AddToSelection 不会导致对所选内容进行任何更改，并且 SelectionChange 事件不会触发。
将定期约会或任务中的项目指定为 AddToSelection 方法的参数时，请确保在传递参数之前，首先通过使用 IncludeRecurrences 属性和 Items 集合展开重复周期来获取该实例。 如果不扩展重复周期并获取序列中的匹配项，则传递一个代表约会或任务系列的实例变量， AddToSelection 方法将对该系列而不是事件执行操作。
请注意，可以使用 AddToSelection 来将项目添加到所选内容，但无法将对话标头添加到所选内容。
支持和反馈
有关于 Office VBA 或本文档的疑问或反馈？ 请参阅 Office VBA 支持和反馈，获取有关如何接收支持和提供反馈的指南。