Outlook) (Explorer.AddToSelection 方法

將指定的 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 會觸發。
  • 除非檢視是 Calendar 檢視,否則讀取窗格不會變更其顯示的項目,在此情況下,呼叫 AddToSelection 可能會導致 [讀取] 窗格顯示不同的項目。
>=1 否
  • 項目已新增至選取範圍。
  • SelectionChange 會觸發。

如果已在使用中檔案總管中選取指定的項目,則呼叫 AddToSelection 不會導致選取範圍發生任何變更,且不會觸發 SelectionChange 事件。

當您將週期性約會或工作中的項目指定為 AddToSelection 方法的引數時,請務必在傳遞引數之前,先使用 IncludeRecurrences 屬性和 Items 集合展開週期,以取得該項目的執行個體。 如果不展開定期並取得數列中的出現項目,則會傳遞代表約會或工作數列的執行個體變數,而 AddToSelection 方法會在數列上運作,而不是在出現項目上執行。

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

支援和意見反應

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