取消選取使用中檔案總管中指定的 Microsoft Outlook 項目。
語法
運算式。RemoveFromSelection (項目)
運算式 代表 Explorer 物件的變數。
參數
| 名稱 | 必要/選用 | 資料類型 | 描述 |
|---|---|---|---|
| 項目 | 必要 | Object | 要從選取範圍中移除的項目。 |
註解
使用中檔案總管中的選取範圍是由 Explorer.Selection 屬性所傳回的 Selection 物件所代表。
若要將項目從選取範圍中移除,項目在使用中檔案總管內的目前檢視中必須是可選取狀態。 不過,項目不一定要顯示在檢視中。
當您在下列條件的情況下呼叫 RemoveFromSelection 方法時,Outlook 會傳回錯誤:
- 指定的項目不存在於使用中檔案總管內的目前檢視中。
- 指定的項目正在使用中檔案總管內的目前檢視中進行編輯。
- 目前的檢視已經過篩選,篩選的應用程式已從檢視中移除該項目。
- 指定的項目尚未儲存。
- 指定的項目代表 StorageItem。
- 目前檢視是交談檢視。
- 使用中檔案總管內沒有目前的檢視。
如果已選取指定的項目,則呼叫 RemoveFromSelection 將導致 SelectionChange 事件觸發。 如果未選取項目,則呼叫 RemoveFromSelection 不會導致 SelectionChange 事件觸發。
呼叫 RemoveFromSelection 不會捲動檢視以讓您在檢視中看到指定的項目,而且不會展開或摺疊檢視中的群組。
下表說明呼叫 RemoveFromSelection 的結果,考量 Selection.Count 屬性) (的任何目前選取範圍、是否顯示 [讀取窗格],以及指定的項目是否顯示在 [讀取窗格] 中。
| 現有的 Selection.Count | 顯示讀取窗格 | 讀取窗格中顯示的特定項目 | 結果 |
|---|---|---|---|
| 1 | 是 | 是 |
|
| >1 | 是 | 否 |
|
| >1 | 是 | 是 |
|
| >=1 | 否 | 不適用 |
|
如果指定的項目存在於目前檢視中,但在該檢視中並不是選取狀態,則呼叫 RemoveFromSelection 不會造成選取範圍的變更,也不會觸發 SelectionChange 事件。
當您將週期性約會或工作中的項目指定為 RemoveFromSelection 方法的引數時,請務必在傳遞引數之前,先使用 IncludeRecurrences 屬性和 Items 集合展開週期,以取得該事件的執行個體。 如果不展開週期並取得數列中的項目,您會傳遞代表約會或工作數列的實例變數,而 RemoveFromSelection 方法會在數列上執行,而不是在項目上執行。
支援和意見反應
有關於 Office VBA 或這份文件的問題或意見反應嗎? 如需取得支援服務並提供意見反應的相關指導,請參閱 Office VBA 支援與意見反應。