Outlook (Explorer.RemoveFromSelection 方法)

取消在使用中總管中選取指定的 Microsoft Outlook 專案。

語法

運算式。RemoveFromSelection (Item)

表達 代表 Explorer 物件的 變數。

參數

名稱	必要/選用	資料類型	描述
項目	必要	Object	要從選取範圍中移除的項目。

註解

使用中總管中的選取範圍是由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 支援與意見反應。