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