共用方式為

ICustomDestinationList：：AddUserTasks 方法 (shobjidl_core.h)

  • 發行項

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

語法

HRESULT AddUserTasks(
  [in] IObjectArray *poa
);

參數

[in] poa

類型： IObjectArray*

IObjectArray 的指標，代表一或多個 IShellLink (，或較罕見地，代表工作的 IShellItem) 物件。

注意 這裡使用的任何 IShellLink 都必須透過 SetArguments 宣告自變數清單。 不支援將沒有自變數的 IShellLink 物件新增至自定義類別。 用戶無法從跳躍清單釘選或取消釘選這種類型的專案，也無法新增或移除這些專案。
 

傳回值

類型： HRESULT

如果成功，則傳回S_OK，否則傳回錯誤值。

備註

您必須先呼叫 ICustomDestinationList：：BeginList ，才能呼叫此方法。

[ 工作 ] 類別標頭預設一律會顯示在清單中，除非類別是空的。 無法變更此標頭文字。 它會以用戶的選取語言顯示。

[ 工作 ] 類別即使一律顯示為快捷方式清單中的最後一個類別，仍優先於清單中所有其他類別。 此清單已填滿，然後剩餘的空間會配置給其他類別。 不同於其他類別，用戶無法移除或釘選 [ 工作 ] 類別中的專案。 應用程式必須將此類別中工作的值與此類別中工作的使用者，與其他類別所需的空間進行平衡。

工作應該套用至整個應用程式;它們並非專屬於個別視窗或檔。 針對更細微的內容工作，應用程式可以透過 縮圖工具列提供它們。

注意 強烈建議工作清單是靜態的。 不論應用程式的狀態或狀態為何，工作清單都應該維持不變，即使應用程式未執行，這些工作仍可供使用。 使用 AddUserTasks 不會以程式設計方式禁止在工作清單更新時變更工作清單，但您應該考慮這可能會混淆不預期跳躍清單的該部分變更的使用者。 不過，如果應用程式選擇變更工作的狀態，例如「登入」到「註銷」，則該應用程式必須負責確保工作清單正確且最新。 此外，如果應用程式意外關閉，任務欄會使用其最後一個已知良好的工作清單版本，而不需要呼叫應用程式來要求一個，因而導致可能過期的專案。
 

透過 poa 指向的 IObjectArray 提供的IShellLink 實例必須提供下列專案：

顯示名稱必須透過專案的 System.Title (PKEY_Title) 屬性來設定。 屬性可以直接保存顯示名稱，也可以是間接字串表示法，例如 “@shell32.dll，-1324”。 間接字串可讓專案名稱以用戶的選取語言顯示。

您可以選擇性地將 [描述] 字段 (SetDescription) 設定為提供跳躍清單中專案的自定義工具提示。

工作清單也可以包含分隔符。 這些是藉由包含空白 IShellLink (這是自變數清單需求) 的單一例外狀況，並透過 IShellLink 物件的 IPropertyStore 介面將其 System.AppUserModel.IsDestListSeparator 屬性設定為 TRUE。 IShellLink 中的任何其他值都會被忽略。 分隔符不會佔用清單中的完整空間，也不會計入清單中的項目數。 如果兩個分隔符之間沒有專案提供，則不會顯示其中一個分隔符。 也會忽略清單開頭或結尾的分隔符。

規格需求

需求 值
最低支援的用戶端 Windows 7 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 R2 [僅限桌面應用程式]
目標平台 Windows
標頭 shobjidl_core.h (包含 Shobjidl.h)
程式庫 Shell32.lib
Dll Shell32.dll (6.1 版或更新版本)

另請參閱

ICustomDestinationList

ICustomDestinationList：：AppendCategory

ICustomDestinationList：：AppendKnownCategory

任務列延伸模組