ICustomDestinationList 介面 (shobjidl_core.h)

  • 發行項

公開可讓應用程式提供自定義跳躍清單的方法，包括目的地和工作，以在任務欄中顯示。

繼承

ICustomDestinationList 介面繼承自 IUnknown 介面。 ICustomDestinationList 也有下列類型的成員：

方法

ICustomDestinationList 介面具有這些方法。

 
ICustomDestinationList：：AbortList

停止 ICustomDestinationList：：BeginList 起始的跳躍清單建置會話，而不認可任何變更。
ICustomDestinationList：：AddUserTasks

指定要包含在自定義跳躍清單之 [工作] 類別中的專案。
ICustomDestinationList：：AppendCategory

定義自訂類別及其包含的目的地，以包含在自定義跳躍清單中。
ICustomDestinationList：：AppendKnownCategory

指定自定義跳躍清單應該包含經常或最近類別目錄。
ICustomDestinationList：：BeginList

起始自定義跳躍清單的建置會話。
ICustomDestinationList：：CommitList

宣告由呼叫 ICustomDestinationList：：BeginList 起始的跳躍清單已完成且可供顯示。
ICustomDestinationList：:D eleteList

刪除指定應用程式的自定義跳躍清單。
ICustomDestinationList：：GetRemovedDestinations

擷取使用者從這個自定義跳躍清單所要取代的現有跳躍清單中移除的目前目的地清單。
ICustomDestinationList：：SetAppID

指定應用程式的唯一應用程式使用者模型標識碼 (AppUserModelID) ，其任務欄按鈕會保存透過這個介面的方法所建置的自定義跳躍清單。 這個方法是一個選擇項目。

備註

實作時機

此介面的實作會在 Windows 中以CLSID_DestinationList的形式提供。 第三方不會實作此介面。

使用時機

跳 清單 同時包含目的地和工作清單。
  • 目的地 是根據個人使用方式，出現在 [最近]、[ 頻繁] 或自定義類別中的專案。 目的地可以是檔案、資料夾、網站或其他以內容為基礎的專案，但不一定是檔案支援。 目的地可以視為事物或名詞。 用戶可以從跳躍清單釘選或移除目的地。 它們通常由 IShellItem 物件表示，但也可以是 IShellLink 物件。
  • 工作 是在套用至該應用程式所有使用者的應用程式中執行的常見動作，不論個別的使用模式為何。 工作可以視為動作或動詞。 無法釘選或移除工作。 它們是由 IShellLink 物件表示。

任務欄會提供每個任務欄按鈕與跳躍清單。 根據預設，跳躍清單包含 [最近 ] 類別，此類別會透過 SHAddToRecentDocs 或通用檔案對話框自動填入檔案型應用程式。 若要將 [最近] 類別取代為 [常用 ] 類別或定義、新增及填入自己的自定義類別，應用程式必須呼叫這個介面的方法。 應用程式也可以根據應用程式的架構和預定用途，提供自己的工作。

注意 應用程式必須是檔類型的已註冊處理程式，該類型的專案才會出現在其跳躍清單中。 不過，它不需要是該文件類型的默認處理程式。
 
自定義跳躍清單旨在根據先前的應用程式使用方式，或透過指出專案對使用者很重要的動作，例如將專案新增至 [我的最愛] 清單的使用者，來呈現應用程式已視為重要的內容。

應用程式必須呼叫此物件，才能將自定義跳躍清單提供給任務列UI。 系統永遠不會查詢應用程式以取得資訊。

當應用程式提供自定義跳躍清單時，它會處理該清單的特定責任。 自定義類別必須以一致的方式填入與跳躍清單的預期用法一致。 如果專案已刪除，則必須檢查清單中的專案是否有效或正常失敗。 如果使用者從清單中移除專案，則必須接受該移除。

自定義跳躍清單永遠不會在變更現有清單中的元素上真正更新。 相反地，舊清單會取代為新的清單。

ICustomDestinationList 方法呼叫以建置及顯示自定義跳躍列表的基本順序如下：

  1. 只有在應用程式提供自己的 AppUserModelID) 時，才需要 SetAppID (
  2. BeginList
  3. AppendCategory、 AppendKnownCategory、 AddUserTasks 或任何這三種方法的組合。
  4. CommitList

規格需求

需求 值
最低支援的用戶端 Windows 7 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 R2 [僅限傳統型應用程式]
目標平台 Windows
標頭 shobjidl_core.h (包括 Shobjidl.h)

另請參閱

任務列延伸模組