Explorer.AddToSelection 方法 (Outlook)

將指定的 Microsoft Outlook 專案新增至使用中檔案總管中的選取範圍。

語法

運算式。AddToSelection (專案)

表達 代表 Explorer 物件的 變數。

參數

名稱	必要/選用	資料類型	描述
項目	必要	Object	在使用中檔案總管內新增到選取範圍的項目。

註解

使用中總管中的選取範圍是由Explorer.Selection屬性傳回的Selection物件表示。

為了供人選取，項目在使用中檔案總管內的目前檢視中必須是可選取狀態。 使用 IsItemSelectableInView 方法來判斷是否可以在檢視中選取專案。 項目不一定要顯示在檢視中。

在下列情況下，當您呼叫 AddToSelection 方法時，Outlook 會傳回錯誤：

• 指定的項目不存在於使用中檔案總管內的目前檢視中。
• 指定的項目正在使用中檔案總管內的目前檢視中進行編輯。
• 目前的檢視已經過篩選，而且篩選的應用程式已從檢視中移除專案。
• 指定的項目尚未儲存。
• 指定的專案代表 StorageItem。
• 使用中檔案總管內沒有目前的檢視。

如果項目未經選取，或項目在目前檢視中是可選取狀態，則呼叫 AddToSelection 會觸發 SelectionChange 事件。

呼叫 AddToSelection 不會捲動檢視以讓您在檢視中看到選取的項目，而且也不會展開或摺疊檢視中的群組。

下表說明呼叫 AddToSelection的結果，並考慮 Selection.Count 屬性) (目前的任何選取範圍，以及是否顯示 [閱讀] 窗格。

現有的 Selection.Count	顯示的讀取窗格	結果
0	是	項目已新增至選取範圍。 SelectionChange 引發 。 [閱讀] 窗格會顯示專案。
0	否	項目已新增至選取範圍。 SelectionChange 引發 。
>=1	是	項目已新增至選取範圍。 SelectionChange 引發 。 除非檢視是 [行事曆] 檢視，否則讀取窗格不會變更它所顯示的專案，在此情況下，呼叫 AddToSelection 可能會導致 [閱讀] 窗格顯示不同的專案。
>=1	否	項目已新增至選取範圍。 SelectionChange 引發 。

如果已在使用中檔案總管中選取指定的專案，呼叫 AddToSelection 並不會對選取範圍產生任何變更，而且不會引發 SelectionChange 事件。

當您將週期性約會或工作中的專案指定為 AddToSelection 方法的引數時，請確定在傳遞引數之前，先使用 IncludeRecurrences 屬性和 Items 集合展開週期，以取得出現的實例。 如果您未展開週期並取得數列中的出現次數，您會傳遞代表約會或工作系列的執行個體變數， 而且 AddToSelection 方法會在數列上運作，而不是在發生次數上運作。

請注意，您可以使用 AddToSelection 將項目新增至選取範圍，但是您無法將交談標題新增至選取範圍。

支援和意見反應

有關於 Office VBA 或這份文件的問題或意見反應嗎？ 如需取得支援服務並提供意見反應的相關指導，請參閱 Office VBA 支援與意見反應。