Outlook) (Explorer.RemoveFromSelection 方法

取消選取使用中檔案總管中指定的 Microsoft Outlook 項目。

語法

運算式。RemoveFromSelection (項目)

運算式 代表 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 支援與意見反應。