_Explorer.AddToSelection(Object) 方法

定义

命名空间:

Microsoft.Office.Interop.Outlook

程序集:

Microsoft.Office.Interop.Outlook.dll

将指定的Microsoft Outlook项添加到活动资源管理器中的选定内容。

public:
 void AddToSelection(System::Object ^ Item);

public void AddToSelection (object Item);

Public Sub AddToSelection (Item As Object)

参数

Item

Object

添加到活动资源管理器中选定内容的项目。

注解

活动浏览中的选定内容由 Selection 属性返回 Selection 的 对象表示。

若要选择项目，该项目在活动资源管理器的当前视图中必须是可选择的。 IsItemSelectableInView(Object)使用 方法确定是否可以在视图中选择该项。 该项目不必在视图中可见。

在以下情况下 Outlook 调用 AddToSelection 方法时返回一个错误:

如果未选择该项，并且可在当前视图中选择，则调用 AddToSelection 会导致 SelectionChange 触发事件。

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

下表说明了调用 AddToSelection 的结果，其中考虑了当前选择 (Count 属性) 以及阅读窗格是否显示。

	0	是	项目将添加到选定内容中。SelectionChange 触发。阅读窗格显示该项。
	0	否	项目将添加到选定内容中。SelectionChange 触发。
	>=1	是	项目将添加到选定内容中。SelectionChange 触发。阅读窗格不会更改它显示的项目，除非视图是日历视图，在这种情况下，调用 AddToSelection 可能会导致阅读窗格显示不同的项目。
	>=1	否	项目将添加到选定内容中。SelectionChange 触发。

如果指定的项已选择在活动资源管理器中，调用 AddToSelection 不会导致任何更改为所选内容， SelectionChange 事件不会触发。

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

请注意，可以使用 AddToSelection 来将项目添加到所选内容，但无法将对话标头添加到所选内容。